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Preface 


This manual describes the functions of POWER/VS and their usage. 
POWER/VS is a component program of the DOS/VS System Control Program. 


Executing jobs under POWER/VS has the following advantages: 


e Faster job throughput because the partition is only used for job 
execution and needs not to wait for slow unit record (UR) devices. 


e Better utilization of UR devices. They can be shared between 
partitions. 


e Support of the major BSC and SNA terminals. 

The manual is designed both as a guide to installing POWER/VS under your 
DOS/VS supervisor and as a reference source in the day-to-day use of 
POWER/VS as your input and output spooling facility for DOS/VS. 


As a system programmer, you will find detailed information concerning: 


e The preparation of your DOS/VS supervisor for the installation of 
POWER/VS. 


e The calculation of the real and virtual storage space for the 
POWER/VS partition. 


e The macro instructions provided for the generation of POWER/VS. 

e The layout of the POWER/VS account records. 

As an application programmer, you will be informed about: 

e The use of POWER/VS in application programs, even though these 
programs might be designed not to execute in a POWER/VS-controlled 


partition. 


e The possibilities of controlling job accounting and output 
segmentation within your application programs. 


As a DOS/VS system operator, you will find detailed information on: 
°e How to start, control, and terminate the execution of POWER/VS. 


e How to start, supervise, and terminate the execution of POWER/VS 
tasks. 


e How to manipulate the characteristics of POWER/VS jobs and to control 
the processing of POWER/VS queues. 


This manual consists of four chapters and five appendixes containing the 
following information: 


Chapter 2 describes how to plan the installation of POWER/VS, how to 
calculate the POWER/VS storage requirements, and how to code the 
POWER/VS generation macros. In addition, this chapter lists the 
terminals that you may use with the POWER/VS RJE support. 
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Chapter 3 lists the POWER/VS central operator commands, the statements 
available with the POWER/VS Job Entry Control Language, and the 
statements provided for the use of the POWER/SVS AUTOSTART feature. This 
chapter also describes the cross-partition communication macros and the 
macros available for POWER/VS job accounting and output segmentation. 


Chapter & describes, in many examples, the day-to-day use of POWER/VS 
and POWER/VS RJE as seen from the central system operator's point of 
view. 


Appendix _A is a detailed discussion of a POWER/VS function called data 
compaction. This function, which is available with the POWER/VS RJ#,SNA 
support, can be selected in the POWER/VS generation procedure. 


Appendix B provides specific information concerning the data flows 
between the central system and remote terminals in the POWER/VS RJE,SNA _ 
environment. 


Appendix C summarizes the VTAM LOGON BIND requirements with respect to 
the POWER/VS RJE,SNA support. 


Appendix D shows two examples of a status report produced after issuing 
the PDISPLAY command. These examples apply to the IBM 3800 Printer. 


Appendix E provides information on coding and using reader exit 
routines. 


System and application programmers are expected to be familiar with 
DOS/VS system generation procedures and with multiprogramaming functions 
under DOS/VS. Central system operators should be familiar with the 
operating procedures in a DOS/VS multipartition environment. 
Publications related to the information given in this manual are listed 
in the Bibliografhy. 
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Summary of Amendments 


Edition GC33-6048-0 describes POWER/VS as a component 


program of the DOS/VS SCP. 

The following enhancements are documented: 
° Additional device support 

° Increased number of partitions 

° Library device independence 


e Extended support for RJE,SNA work stations. 


ee ee ee ee ee ee 


independent component release (ICR) of the IBM 3800 
Printer under POWER/VS. 


Edition GC33-6048-1 includes corrections and enhancements 
to the previous edition. 


Changes resulting from the ICR for the IBM 3800 Printer 
are included in this manual. The pertinent figures and 
text portions are marked so that users who have not 
installed the ICR can skip these changes. 


The following enhancements are described: 
"Job Accounting" in Chapter 3, “Assigning Dummy Devices" 
and "Changing Partition Priorities" in Chapter 4, 


“Examples of Status Report Output" in Appendix D, and 
"Reader Zxit Routine" in Appendix EB. 
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Chapter 1. Introduction to POWER/VS 


POWER/VS is designed to improve the throughput of a computing system by 
separating unit-record input and output operations (that is, reading 
card or diskette input, punching cards, and printing reports) and 
internal computing operations of application programs in a DOS/VS 
multiprogramming environment. This process, which is called "spooling" 
(an acronym derived from the term "Simultaneous Peripheral Operations 
On-Line"), results in overlapping the unit-record I/O operations for all 
controlled partitions with the execution of application programs in 
these partitions. To achieve this, POWER/VS stores all unit~record 
input and output in input and output queues on disk. When a unit-record 
device is available to read input or to punch or print output, POWER/VS 
either stores the input data in the input queue or retrieves list or 
punch output from an output queue and transfers it to that device. When 
an application program in a POWER/VS-controlled partition is ready to 
accept input or is about to produce output, POWER/VS retrieves its input 
from the queue associated with the application program’s partition and 
stores output in the associated output queue on disk. 


Hardware Supported by POWER/VS 


POWER/VS operates in virtual mode in one partition of the DOS/VS systen. 
The system dispatching priority of the POWER/VS partition must be higher 
than the priorities of the partitions it is serving. 


POWER/VS maintains input and output queues on direct access storage for 
the card readers, diskette I/O units (input only), card punches, and 
printers associated with the partitions under its control. These queues 
are filled or emptied by the appropriate physical devices. Whena 
vrogram in a POWER/VS-controlled partition makes an input or output 
request to one of these devices, POWER/VS provides the next record from 
the appropriate input queue or collects the record and places it in the 
appropriate output queue. These operations take place at main storage 
or direct access storage speeds and are overlapped with the execution of 
programs in other partitions; hence, programs execute faster and take 
better advantage of the system environment. Application programs 
executing in POWER/VS-controlled partitions do not require nodifications 
to take advantage of POWER/VS. 


The POWER/VS queues are under optional operator control. This allows 
the DOS/VS system operator to modify the order in which programs are 
executed by manipulating the queues with POWER/VS commands. Because 
POWER/VS allows job input and output also from and to remote terminals, 
the possibility of manipulating queues is also available to terminal 
operators. Further control is available to the application programmer 
through the option of using Job Entry Control Language (JECL) statements 
within the job input stream. 


The user generates POWER/VS through the assembly of the POWER/VS macros. 
These macros allow the user to specify the options appropriate to his 
system environment. Among the options that the user may select are 
features such as the inclusion or suppression of job accounting 
routines, of system network architecture (SNA) support, and others. 
Details concerning the generation of POWER/VS are described in 

Chapter 2. 
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LOCAL UNIT RECORD I/0 DEVICES 


POWER/VS supports the following unit-record devices for peripheral input 
and output: 


IBM 
IBM 
IBM 
IBM 
IBM 
IBM 
IBM 
IBM 
IBM 
IBM 


IBM 
IBM 
IBM 
IBM 
IBM 
IBM 
IBM 


IBM 


WA? 
2501 
2520 
2540 
2560 
3501 


Card Read Punch 

Card Reader 

Card Read Punch 

Card Read Punch 
Multifunction Card Machine 
Card Reader 


3504/3505 Card Reader 


3521 
3525 
5425 


1403 
T4H43 
3203 
3211 
3784 
3800 
5203 


3540 


Card Punch 
Card Punch 
Multifunction Card Unit 


Printer 
Printer 
Printer 
Printer 
Line Printer 
Printer 
Printer 


Diskette Input/Output Unit (input only). 


DIRECT ACCESS STORAGE DEVICES 


POWER/VS uses three types of files: the account file, the queue file, 
and the data file. For these files, POWER/VS requires direct access 
storage. 
storage devices, which may be any of the following: 


IBM 
IBM 
IBM 
ISM 
IBM 
IBM 


2314 
2319 
3330 
3333 
3340 
3350 


Different POWER/VS files may reside on different direct access 


Direct Access Storage Facility 
Disk Storage 

Disk Storage (including Model 11) 
Disk Storage and Control 

Direct Access Storage 

Direct Access Storage. 


REMOTE JOB ENTRY DEVICES 


To enter jobs into the system using remote terminals, and to obtain 
output at such terminals, the POWER/VS remote job entry (RJE) feature 
supports the following BSC and SDLC terminals: 


IBM 
IBM 
IBM 
ISM 
IBM 
IBM 
IBM 


2770 
2780 
3741 
3741 
3770 
3780 
3790 


Notes: 
emulate the 2770, 2780, or 3780 line discipline, and all SNA work 
stations that follow the SNA rules defined for LUTYPE1. For details 
refer to Appendix B, "RJE,SNA I/0 Specifications". 


Data Communication Systen 

Data Transmission Terminal 

Data Station (Model 2) 

Programmable Work Station (Model 4) 

Data Communication System in BSC or SNA mode 
Data Communications Terminal 

Communication System. 


In general, all BSC terminals and/or systems are supported that 


2 POWER/VS Installation Guide and Reference 


The following applies to 3770 terminals: In BSC mode, 3770s are 
supported as 2770 or 3780 terminals, in SNA mode, LUTYPE1 protocols must 
be used. 


Up to 25 BSC terminals or up to 200 SDLC and BSC terminals can communi~ 
cate concurrently with the central system via switched or nonswitched 
lines. In noncuncurrent operation on switched lines, any number of BSC 
terminals may be controlled by POWER/VS as long as the maximum number of 
concurrently operating BSC terminals does not exceed 25. 


Work Station User's Guide, GC33-6049. 


Concepts and Functions 


The basic concept of POWER/VS has not changed since the first appearance 
of its predecessor, POWER, when non-VS DOS allowed the quasi- 
simultaneous execution of two or three independent programs in different 
partitions residing in the main storage of an IBM System/360. The 
implementation of POWER/VS in DOS/VS maintains this spooling concept 
mentioned earlier. In detail, POWER/VS operation includes the following 
major activities: 


* Input. POWER/VS reads the job streams {job control statements, 
programs, and data cards) for the individual partitions and stores 
these in input queues on disk. The input may be entered from: 
= A local card reader device. 

- A local diskette device. 

= A remote BSC terminal. 

= A remote SNA (SDLC) work station with a console and an input 
device (card reader or 80-column card-image disk or diskette 


device). 


- An outside partition not controlled by POWER/VS. 


e Execution. From the input queue on disk, the jobs are transferred by 
POWER/VS to the designated partitions and executed. The jobs contain 
all required input and may optionally contain JECL statements to 
indicate individual job execution or I/O reguirements. 


e Qutput. Job output (printer and punch) of every job is stored in 
output gueues on disk (or tape) by POWER/VS before it is finally 
processed as output: 

7 For a local printer or punch device. 

- For a remote BSC terminal. 

= For a remote SNA (SDLC) work station where the output can either 
be produced by an appropriate work station unit-record device or 
where it can be temporarily stored on disk or diskette. In the 
latter case, the user can perform remote spooling of his job 
output. 


= For an outside partition not controlled by POWER/VS. 
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° Control. Throughout the different steps of input, execution, and 
output, the jobs running under POWER/VS are within the management of 
the user through the following command language facilities: 


- Job Entry Control Language (JECL). Along with his input job 
decks, the user may insert JECL commands to describe individual 
job execution or I/O requirements. 


- Central operator commands. From the starting of input until the 
final discharging of list and punch output, the central operator 
may start and stop the job execution, display or alter execution 
and I/0 performance characteristics, or perform similar 
functions. 


- Remote terminal operator commands. Similar to the central 
operator, the remote terminal operator may perform many of the 
functions as above for all jobs submitted by him or routed to 
him. 


- Cross-partition communication macros. These macros enable an 
application program not running under POWER/VS control to 
supervise jobs running under POWER/VS control in the same way as 
the central or remote terminal operator. However, this job 
supervision from outside POWER/VS is restricted to the use of 
five commands. Por details, refer to the description of the 
CTLSPOOL macro under "Cross-Partition Communication Macros" in 
Chapter 3. 


Job input as well as job output may be held in the POWER/VS queues for 
execution or printing/punching at a later time. This allows the user to 
hold jobs that need, for example, two hours of execution or printing 
time until the system is less occupied. 


e Accounting. POWER/VS optionally creates accounting information for 
each job running under its control. 


e Segmentation. Turnaround time for jobs with extensive printed or 
punched output can be improved by segmenting the output, which means 
that parts of the output are printed or punched before the entire job 
is finished. Segmentation is always done on logical boundaries. Por 
a printer this is a page (skip to channel 1), for a punch this is a 
card. The following types of output segmentation can be 
distinguished, based on the event that initiates it: 


- Count-driven output seqmentation. You can specify the number of 
print pages and/or punched cards in the output file, after which 
physical output should be initiated, by means of the RBS= 


parameter of the POWER macro during POWER/VS generation. 


- Data-driven output segmentation. You may submit two or pore 
* $$ LST (* $$ PRT) statements within the boundaries of one 
POWER/VS job. Each of these statements causes an individual list 


queue entry to be created. 


* Program-driven output segmentation. In your application program 
you may use either the SEGMENT macro to separate the output, or 
the LFCB macro, which causes segmentation before loading the new 
FCB. You may also issue the SETPRT macro requesting a printer 
setup that requires operator intervention, changes copy grouping, 
or specifies a copy number (CINDX) greater than one. 
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| e Central Operator Control. The execution of POWER/VS can be 
controlled by the DOS/VS console operator. Using POWER/VS central 
operator commands, the operator can perform any of the following 
functions: 


- Rearrange the order of job streams in input queues or the order 
in which the output from different jobs is to be printed and/or 
punched. 


= Delete input job streams or job output waiting in queues. 


~ Hold job streams or job output in input or output gueues for 
later consideration or processing. 


- Interrupt printer or punch output, for example, to free a device 
urgently required by some other task. 


- Restart printer or punch output, either from the beginning or 
from any desired point within the data strean. 


= Specify the number of copies to be printed or punched from any 
data file. 


- ketain input job streams in the queues even after processing of 
the jobs has been completed, or retain printer and/or punch 
output in the queues even after it has been printed or punched 
completely. . 


i ® Teleprocessing Facility. POWER/VS also offers a teleprocessing 
facility, called Remote Job Entry (RJE). With RJE, jobs may be 
submitted from remote terminals. Once a job has been entered into 
the input job gueue, the execution proceeds under DOS/VS supervision. 
All data files required by the job are subject to DOS/VS 
specifications, just as if the job had been entered locally. RJE job 
output may be directed to the terminal from which the job was 
entered, to other terminals, or to the local output unit of the 
system. 


With these functions, POWER/VS ensures a maximum of flexibility for a 
DOS/VS multiprogramming environment and achieves an optimum usage of the 
system resources available in any installation. 


Pigure 1-1 gives an overview of the major functions of POWER/VS. 


A Reader/Writer task performs the read/write functions of a POWER/VS 
job. The operator can call for concurrent execution of as many 
read/write tasks as he has physical I/0 devices available. 


An Execution Processor task provides simulated input/output support for 
the execute function. An execution task is available for each partition 
under POWER/VS control. An execution output task is automatically 
initiated when required by a user job. 


For more information on POWER/VS tasks, refer to DOS/VS POWER/VS Logic 
Part 1, SY33-8576. 
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Pigure 1-1. The Major Functions of POWER/VS 
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User Responsibilities 


Before you can start to generate POWER/VS, you must tailor your 
operating system (DOS/VS) to the requirements imposed by POWER/VS. This 
includes: 


e The definition of POWER/VS-specific parameters (one is required) in 
the macro instructions for the DOS/VS system generation. 


e The preparation of POWER/VS generation macros. To tailor POWER/VS to 
your needs, you can specify optional features of this system, such as 
the job accounting support, the SNA support, and others in a 
generation table which you then have to assemble, link-edit, and 
catalog. 


e The allocation of both virtual and real storage space for the 
POWER/VS partition. 


® The assignment of the highest system dispatching priority for the 
POWER/VS partition over the user partitions assigned to run under 
POWER/VS. 


Details concerning the parameters required for the DOS/VS systen 
generation are contained in the publication DOS/VS System Generation, 
GC33-5377. For more information about the generation of POWER/VS, refer 
to Chapter 2 of this manual. 


Input/Output Description 


POWER/VS intercepts input and output requests issued by application 
programs that execute in independent DOS/VS partitions. As stated 
before, these partitions have a lower priority in DOS/VS than the 
POWER/VS partition that controls them. 


Each activity performed by POWER/VS receives input and produces output. 
That is, to satisfy an input operation requested by an application 
program, POWER/VS reads the input destined for this application and 
writes it onto a data file,’ from where the application program can 
retrieve it later for processing. Inversely, to satisfy an output 
request issued by an application program, POWER/VS, after having 
collected the application program output in a data file, reads this file 
and prints or punches the data at the appropriate unit-record output 
device or sends it to the designated remote terminal or work station. 


Concurrently with the production of data file entries, POWER/VS creates 
an entry in a queue file giving summary information on the entries in 
the data file. There are three types of queue entries corresponding to 
the three types of data: reader queue, list queue, and punch queue 
entries. The queue file gives POWER/VS a warm start capability in case 
of a system breakdown. 


In more detail, the input to and the output from POWER/VS consists of 
one or pore of the items listed below. 


POWER/VS input can be: 
* Control information, which can be either POWER/VS job entry control 
language (JECL) statements, central operator commands, POWER/VS 


remote job entry (RJE) commands, or JECL commands contained in cross~- 
partition communication macros. . 
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* DOS/VS job control statements. 


e Application-oriented data provided from a card or diskette reader or 
from a remote terminal or work station. 


e DOS/VS source statement library books. These may be included in the 
input job stream by using a special JECL command (Source Library 
Include; see the description of the * $$ SLI command in Chapter 3). 


In this case, the output consists of data stored in an input data file. 


POWER/VS output consists of data stored in an output data file, and of 
messages. In this case, the output can be: 


e Printer (list) output 
e Punch output. 
This output can be directed to unit-record devices, to magnetic tape 


devices, to remote terminals or work stations, or to other partitions 
that do not execute under control of POWER/VS. 


Environmental Considerations 


This section contains information pertaining to the planning of a 
POWFR/VS installation and discusses installation-related alternatives 
with respect to the use of POWER/VS. 


PROGRAMMING SYSTEMS 


The POWER/VS modules are written in IBM Systen/370 Assembler language. 
The following programs are used in the support of POWER/VS: 
1. Required software support: 


- DOS/VS Release 34 (Program Number 5745-010) 


2. Optional software support for RJE,SNA: 


- DOS/VS Virtual Telecomamunications Access Method (VTAM) Level 2 
(Program Number 5745-010). ' 


- DOS/VS Network Control Program (NCP) Version 5.0 (Program Number 
5747-AS2). 
3. Optional software support for the IBM 3800 Printer: 
- DOS/VS POWER/VS IBM 3800 Printing Subsystem Independent Component 


Release (ICR). 


POWER/VS also operates with the above systems in a virtual machine 
environment under VM/370. 
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System Requirements 


In addition to the system requirements of DOS/VS with the necessary 
features, of VTAM (optionally), and of user programs, POWER/VS has the 
following additional hardware system requirements: 


1. Minimum storage requirements: 


Se eee ee ee 

| K bytes | K bytes | K bytes t 

i (no RJE | (RJE,BSC | (RJE,SNA | 

| support) | support) | support) | 
ho vO aOsS=SwWw0ee_ | 
{ Main Storage | 10 | 14 l 14 | 
| (real) | I | I 
ie een aire ccd a a ah aac aca aa 
| Main Storage | 152 | 174 t 210 ! 
| (virtual) * | (see note) | | (see note) | 
eee ee eee ee eee ew ewe ww ee ee ew ewe ow ew ew ee ww wm i eer oe eo we ww ee we ee wow ew ew ew ee ee | 
| *For the 3800 ICR support, add 4K bytes to each value. I 


| A 2 a | 


Note: Por POWER/VS with RJE,SNA support, or when using an IBM 3800 
Printer, you must specify the SIZE= parameter in the // EXEC POWER job 
control statement. 


The minimum requirement may increase due to maintenance activity. 


2. Maximum resource requirements: 


~ Up to 25 BSC terminals concurrently. Through switched operation, 
more terminals may be in the network nonconcurrently. 


- Up to 200 BSC terminals and SNA work stations (SDLC) 
(concurrently). This figure may include up to 25 BSC terminals. 
Through switched operation, more BSC terminals may be in the 
network nonconcurrently as long as 25 or less BSC terminals are 
operating concurrently with POWER/VS. 


-~ Up to eight logical printers, eight logical punches, and one 
logical reader may be assigned to all partitions under control of 
POWER/VS. 


To use the RJE,SNA capabilities of POWER/VS for the IBM 3790, the 3790 
Communication System with RJE Facility Support is required. 


Timing and Throughput Information 


Although the execution time for a single DOS/VS job may slightly 
increase under the control of POWER/VS (which is due to the strict 
separation of input and output activities from the program execution), 
the overall system performance increases considerably. By adding 
further resources in terms of real and virtual storage and peripheral 
equipment over and above the minimum system requirements for POWER/VS, 
you can further improve the efficiency of your installed IBM System/370. 
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Chapter 2. Installing POWER/VS 


This chapter guides you in the installation of POWER/VS. Before you 
start installing the system, you have to consider a number of topics 
concerning requirements in the available hardware and software. These 
considerations are discussed in the section "Planning the System". The 
next section, "Generating POWER/VS", acquaints you with the macros 
available to generate the system and with the steps to be executed until 
POWER/VS is available in your DOS/VS environment. 


The information in this chapter is supplemented by a summary of the 
terminals supported with POWER/VS RJE and a discussion of some special 
unit-record devices. 


Planning the System 


Before POWER/VS can be installed, you have to ensure the availability of 
certain features in your computer installation environment. These 
prerequisites fall into the following categories: 


e Machine requirements 
e Storage requirements 
e DOS/VS supervisor requirements 


e VTAM and NCP generation requirements (optionally). 


The following sections contain detailed discussions of these topics. 


MACHINE REQUIREMENTS 


POWER/VS operates on any IBM System/370 CPU that is supported by DOS/VS 
Release 34. It resides in a virtual partition with a priority higher 
than that of the partitions it controls. POWER/VS supports programs 
running in real and virtual mode. 


POWER/VS supporting RJE,SNA requires a minimum of 210K virtual and 14K 
real storage. POWER/VS with RJE,BSC requires a minimum of 174K virtual 
and 14K real storage. Without RJE support, 152K virtual and 10K real 
storage are required. Included in these figures is sufficient real and 
virtual storage for one active POWER/VS task. For performance reasons, 
however, and for the simultaneous operation of several POWER/VS tasks, 
you should allocate more real and virtual storage. For details, refer 
to the example given under “Storage Requirements Calculation" later in 
this chapter. 


With the remote job entry (RJE) feature, POWER/VS accepts input fron, 
and routes output to, remote terminals or work stations. The attachment 
of BSC terminals to a central system requires one of the following 
Rinimum configurations: 
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e An IBM 2701 Data Adapter Unit (DAU) with Synchronous Data Adapter, 
Type II, equipped with EBCDIC or ASCII code and transparency, or 


e An IBM 2703 Transmission Control Unit (TCU) with Synchronous 
Attachment, Synchronous Base, Synchronous Terminal Control - EBCDIC 
or ASCII and Synchronous Line Set, and 3704/3705 Communication 
Controller in 270x emulation mode, or 


© For a Model 115 CPU, an ICA with synchronous line group and 
synchronous line medium speed (with or without clock). 


e Por a Model 125 CPU, an ICA either with synchronous line group and 
synchronous line medium speed (with or without clock), or with 
synchronous line low load. 


® For a Model 135 CPU, and Intsagrated Communications Adapter (ICA) with 
a Synchronous Data Adapter, Type II, and transparency. 


The attachment of SNA work stations requires: 
® An IBM 3704 Communications Controller, or 


e An IBM 3705 Communications Controller. 


For a detailed list of the terminals supported by POWER/VS, refer to the 
section "Terminals Supported by POWER/VS" later in this chapter. 


INTERMEDIATE STORAGE REQUIREMENTS 


Intermediate storage in POWER/VS is on disk (tape for output only) and 
contains the queue file, the data file, and optionally the account file. 


Generally, one IBM 2316 disk pack, 100 cylinders on an IBM 3336 disk 
pack, or 200 cylinders on an IBM 3348 data module are sufficient for 
POWER/VS. The POWER/VS files (queue file, data file, and account file) 
need not be on units of the same type. However, if the data file is on 
more than one extent or on more than one physical device, these devices 
must be of the same type. For the 3340, all extents of the data file 
must reside on the same type of 3348 module. Multiple disk extents and 
multiple disk volumes are supported to a maximum of five extents for the 
data file. POWER/VS data files should not reside on a volume containing 
frequently used files. DASD space assigned must be sufficient to 
contain both input and one segment of output for any POWER/VS job. 


Size of the Data File and Queue File 


The data file, which is made up of track groups, and the queue file, 
which is primarily made up of queue records, are directly related. Each 
track group has a corresponding queue record. The size of the data file 
is defined by the total number of track groups, which in turn is limited 
by the number of records in the queue file. 
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In estimating the size of the data file and queve file, you should us 
consider the following: 


¢ The maximum number of POWER/VS jobs in the syStem at any one time 
e The largest volume of spooled I/0 for any job 


¢ The fact whether or not output segmentation is used. 


For the data file extents, estimate separately the total number of 
input/output card images and the total number of line images spooled to 
disk in a typical 8-hour shift. Choose a file size large enough to hold 
half this amount of data. This should prevent POWER/VS from running out 
of file space. File extents can be respecified if they prove to be too 
large or too small (check the status report). 


The queue file should be large enough to support the entire data file: 
that is, there should be one queue record for each track group in the 
data file. It is good practice to allocate six additional queue file 
records for internal POWER/VS usage. 


re a a i ES SY tN 


The size of the physical records written to the data file is determined 

by the DBLK parameter. This also influences the size of the data 

buffers required for each POWER/VS task. If not explicitly specified by 

the user, the system chooses a default block size, which suits the 

characteristics of the disk device assigned to the data file. The a 
default values for each device are shown below: 


pie 
| Device Type |Default Data JApprox. No. of {|Approx. No. of 

! }Block Size }Cards per Block* [Lines per Block** 

| ee ee ee ee ee ee ee oe ee ee ee ee ee es ee ee ee ee eo ew a ei we 
| 2314/2319 1 920 { 11 | 7 

| 3330/3333 952 | 12 | 7 

|} 3340 ! 808 | 10 | 6 

} 3350 | 960 " 12 1 7 


ee ee ee ree a ee ee ee ee ce ee re em eee ee ee a ee ee a a ee ee ee 


[* POWER/VS suppresses trailing blanks; hence these figures represent 
| the minimum values. 
| 
| 


op ames eee eee ee ee eee ee ee ee 


** Based on 132 print positions per line. 
fa a a ee | 


If you specify a value other than the default, it is possible to achieve 
better performance. In general, the smaller the DBLK value is, the less 
real storage is required to execute a given number of tasks. 

Conversely, the larger the DBLK value is, the more real storage is 
required; however, more efficient use is made of intermediate storage 
because the larger the block size, the more spool records per track. 

The more records in a block, the fewer the disk I/0 operations to 
perform. If the data buffer size, which can be increased by 32-byte 
increments, is larger than 1000 bytes, only one data buffer will fit 
into a storage page. The largest buffer size is 2008 bytes, which is 
one data buffer per page with its control information. 
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Number of Track Groups 


After you know your DBLK size, you can determine the track group size. 
You know the number of blocks per cylinder and approximately how many 
records are in each block. 


If the track group size is small (the smallest is 1), then one gqueve 
record is needed for each track on the data file. This results in a 
larger queue file and an overhead in queue record management, but best 
utilizes the disk space available in the data file. If the track group 
size is large (the largest number would be that equal to the number of 
tracks per cylinder), then fewer queue records (one per cylinder) are 
needed. However, because there can be only one POWER/VS job for each 
track group, disk space is wasted on the data file whenever a job does 
not fill a track group. 


If you do not specify a track group size, the system will try to use all 
of the data file. The system calculates the number of tracks within the 
extents provided by the data file. It then determines the number of 
152-byte records it can write into the queuve file. From these two 
figures it determines the number of track groups to allocate, by 
calculating the smallest value possible for TRACKGP, which utilizes the 
largest amount of the data file. 


If during POWER/VS initialization, the TRACKGP specified conflicts with 
the EXTENT information for the data file, the system changes the TRACKGP 
value. You are informed of the new TRACKGP value by message 10091. 


Size of the Account File 


To estimate the size of the account file, you should consider that each 
POWER/VS job can create at least one reader, one list, and one punch 
account record. In addition, each DOS/VS job step within a POWER/VS ‘job 
creates one execution account record. For example, for the 3330 
approximately 170 jobs can be handled by one cylinder of the account 
file. This figure is based on an average of five account records per 
POWER/VS job. 


STORAGE REQUIREMENTS 


Virtual and real storage space must be allocated for the POWER/VS 
partition. Figure 2-1 shows the structure of the POWER/VS partition and 
the types of information stored herein. Figures 2-2 and 2-3 supplement 
the storage space description given in Figure 2-1. An example how to 
calculate the size of the POWER/VS partition and of its corresponding 
storage areas is provided in the section "Storage Requirements 
Calculation” later in this chapter. 


Chapter 2. Installing POWER/VS 13 


eee A A aN 


! Virtual Partition | 
easacmieteatek oc aaa icacate ein a 4 ane aia AA a 
JArea Dis- | | Storage | 
{position [Contents |Requirements | 
! | Jin Bytes } 
Required Permanent Area: 8K 


POWER/VS nucleus and control 
tables 


User area see Figure 2-3 


es er rr, hr 


] 
l 
] 
! 
|Fixable area 
! 
! 
I 


| 
| 
{ 
i 
I 
| 
| 
I 
| 
| 
| | 
| }RUE,SNA support 
| 
} 
I 
| 
! 
| 
| 
| 
| 
| 
I 
| 


| 
POWER/VS code (basic functions) 146K ] 
ea a ee ce ee eh ote a a ee ee ce ee ee ee ee ee ee ee ee ee } 
Optional |Accounting support J4k | a V 
| | ! 
jUser RDREXIT phase |see note 1 | c S 
| I 
|RJE,BSC support } 16K = | 
! 
{Spool manager support 4K |; 8 z 
| (cross-partition) |? = 
| } & ¢ 
[SLI facility 2K | 
| 
| 
| 


| 
| 
| 
| 
| 
! 
| 
J*® POWER/VS SNA support modules } 
Je GETVIS control storage } 
{@ Remote control block storage | 
}¢ SNA unit control blocks storage | 
J® Work area control blocks storage | 
{* LOGON storage | 
j¢ Compaction table storage | 
te Logical unit name storage | 

! 

1 


| 

13800 Printing Subsystem support 

le Work area for 3800 printer {72K 

{ setup processing {see note 2 


a ee ew oe we we we ee a ee i a a ee ro ee ee = 


{Note 1: The size of the RDREXIT phase depends on the amount 
jof user code. 


! 
| 
[Note 2: The amount of 12K is required for each 3800 printer | 
|setup concurrently being processed. | 
l 
| 


1 
}* Ada@ 4K bytes if the 3800 ICR is installed. 
ere eee | 


Figure 2-1. Structure of the Virtual Partition and Storage 


Requirements. The size of the real partition equals the 
size of the permanent plus the size of the fixable area. 
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! 
|} Type of Storage or Control Block |Storage Requirements in Bytes 


irene ne een none eae Oe lgreain gree eager 
{Remote control block (RMCB) for RMCB * r¥32 (see note) 
Jall work stations 


1 
}SNA unit control blocks (SUCBs 
jand LUCBs) for all work stations 


| 

| (SUCB*+LUCB*SESSLIM (max) ) *#S 

| (see note) 

1 

}Work area control blocks (W#ACBs) | 

| I 
| 
I 
I 
! 
| 
! 
f 


(SESSLIM (max) *+1) *WACB*¥WS (see note) 


}LOGON storage for all work 
jstations 


|Compaction table storage for all 
{work stations 


(0.5r + 2) *2K (see note) 


(wscount or number of PRMT macros). 


ee ee oe ew ee we we we we et ae ee ee OOO OO OOO SO we Oe we ee OS Oe Sew OO ew eS we ww OM ee Sw Pewee ew eS Oe Se ew ee 


fLogical unit name storage 1 page 

t a ae ee ee eee ee Oe ee Oe Owe Oe we eee OOO eee ee we wee ewe Ree Oe ee ee 
| Legend: 

I 

| RMCB = 2K 

t 

|r = Number of remote work stations (remote-IDs or number 
! of PRMT macros with TYPE=LUT1). 

! 

| wscount = wscount value specified in POWER macro, SNA para- 
| heter. 

| 

| SUCB = 192 

| 

| LUCB = 160 

H 

[SESSLIM (max) = Highest number of SESSLIM= specifications in all 
| PRMT macros. 

| ei 

JLST = Number of logical printers. Maximum is 3 per work 
| station ° 

| 

| PUN = Number of logical punches, Maximum is 1 per work 
| station. 

i 

| WACB = 1K 

! 

jaws = Number of work stations. Maximum is 200. 

} 

! 

| 


Note: Rounded to the next higher page boundary. 
a a a ee ep er a cee 


Figure 2-2. Space Calculation for RJE,SNA Support Control Blocks 


The virtual partition contains: 


e The Permanent Area. This area of 8K bytes contains the POWER/VS 


= eee eee ee Se ee oe 


hucleus and control tables. 


e« The Fixable Area. This area requires a minimum of 2K space foc 
dynamic control blocks and a variable space for data buffers. The 
size of the data buffer space depends on user specifications for the 
execution processors, RJE lines, and reader and writer tasks. Refer 


to Figure 2-3 for storage sizes and calculations. 
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The Pageable Area. This area contains a 142K space for the POWER/VS 
basic functions, plus space for a number of pageable options. 


The pageable area is optional except for the above 142K which, 
together with the permanent and fixable areas, must be part of the 
virtual partition. 

For POWER/VS with RJE,SNA, the pageable area contains: 

- A space of 142K bytes for the basic POWER/VS functions 

7 The POWER/VS phases for RJE,SNA. 


The GETVIS Area. This area must be provided for RJE,SNA support, or 
when using the IBM 3800 Printer. 


Note: Por RJE,SNA support, you must specify SIZE=192K (as a minimum) 


in the // EXEC job control statement. This value is calculated from 
the sizes of all required POWBR/VS modules (RSIZE + basic function 
modules *+ optional function modules). 


Note: If the 3800 ICR is installed, add 4K bytes to the base values. 


The size of the real partition to be allocated for POWER/VS must 
correspond to the size of the permanent area plus the size of the 
fixable area. In other words, the real partition size (RSIZE, see 
Figure 2-1) equals 8K bytes plus the size of the fixable area. 


POWER/VS does not require any storage from a user's application program 
partition running under POWER/VS control. 


a a aa Ra a EE TEIELS | 


| |Storage 
JPOWER/VS Component or Task (Fixable Area) |Requirenents 
lin Bytes 
[Dynamic control blocks (Must always be considered) [2K 
{SNA control block for RJE,SNA support {192 
jEach local writer task (one buffer) legen + 2N + Y 
}Each local writer task (two buffers) ‘obs + 3N + Y¥ 
|Each local writer task (four buffers) cael + ON + Y 
|Each local card reader task (one buffer) lead + 2N 
{Each local card reader task (two buffers) }5762 + 3N- 
{Each BSC writer task | re + N 
teaei awl writer task eyba +N 
{Each BSC reader task 15763 + N 
|Each SNA reader task isaoa + N 


ni A ce enna 


Figure 2-3 (Part 1 of 2). Base Values for the Storage Calculation for 


the POWER/VS Fixable Area 
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a ee eS ee ee ee 


| 
[POWER/VS Component or Task (FPixable Area) 


JEach card reader task (3540 connected) 


J 
{Each 3540 reader task 


[Each execution reader (one per partition) 


{Each execution writer (max. 16 per partition) 


| 
|Pirst RJE,BSC line 


| 
Hi additional RJE,BSC line 


Cee 2 SSS Oe ew ee! Bee ee OS Oe Ee wee 2 Oe we we eS OOP ee Oe Oe ee SB Peewee Swe Bee eee eee 


3 If 3800 ICR is installed add 32 bytes. 


N 


E 


P 


oq 


rd 


| 
! 
| 
1 
| 
{ 
I 
} 
1 
| 
| 
! 
! 
1 
i 
| 
| 
I 
| 
! 
I 
J 
1 
| 
| 
| 
I 
[Z 
! 


32 * nh, 


32 * e, 


Terminal buffer size. 


Explanation of Variables 


where 


DBLK*t39 


[Storage 


|Requirements 
Jin Bytes 


{7683 + 2N + E 


l 
17042 


| 
14492 


(rounded to the next higher integer) 


+ 


+ 


2N + E 
N*X 


2N + 2 


DBLK is the value specified in the DBLK parameter of the 


POWER macro. 


bytes. 


where 


(R*+8) *26 


-—ee ee 


(rounded to the next higher integer) 


The minimum is 544 bytes, the maximum 2088 


R is the logical record length for the 3540, as specified 


P = 544 is used. 


if SLI statements are to be processed; 


xX = 0 


To process the first SIGNON card, 


otherwise 


{applicable only for execution readers). 


if a 3800 printer is being used; otherwise Y = 0. 


if the device to be spooled is a 3800 printer; otherwise 


Z= 0. 


——s ome ee coe ee ree ee ee ees eee ee ee ee ee ee ee ee ee es ee ee ee ee ee ee ee es ee ee ee ee ee ee ee ee eee ee eee ee 


er re cr A i tn SS ne eee 


Pigure 2-3 (Part 2 of 2). 


the POWER/VS Fixable Area 


Chapter 2. 
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STORAGE REQUIREMENTS CALCULATION 


The following example illustrates how to calculate 
required for an individual POWER/VS installation. 


configuration assumptions given below: 


Assumptions 


POWER/VS is to support the following: 


1. Local POWER/VS operation with: 


One physical reader 

Two physical printers 

One logical printer per partition 

Three partitions controlled by POWER/VS 

SLI facility 

DBLK=544 bytes 

No SPOOL manager support, no user RDREXIT routine, 
support. 


2. RJE,BSC with: 


e One BSC terminal, for example, an IBM 3780. 


3. RJE,SNA with: 


® One IBM 


=i One 
= One 
= One 
a One 
- One 


3770 work station withs 


session (SESSLIM=1) 
logical printer 
logical punch 
logical console 
logical reader 


= Flow interruption allowed. 


e« One IBM 


i Two 
~- Two 
~ One 
= One 


3790 work station with: 


Sessions (SESSLIM=2) 
logical printers 
logical console 
logical reader 


- Flow interruption allowed 
- Logical devices running concurrently. 


e one IBM 


3790 work station with: 


- Five sessions (SESSLIM=5) 
-~ Three logical printers 


= One 
= One 


logical console 
logical reader 


= LU=(nametl,...,name5) specified in PRMT macro 
- Default compaction table specified in PRMT macro 
= Logical devices running concurrently. 


the storage space 
It is based on the 


ho accounting 


Figure 2-4 shows the detailed storage calculation for the above 


configuration: 
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{Ref. {Description |Real |Pageable 
} | Storage jStorage 
| }(in bytes) | (in bytes) 


eee es ee O28 eee | 8 eo Wee eS Ss SPS 2S 2 OO ee! SS SSS ww Se we we Se eS 2! SS Te WSS |! eS ww we Be eS ewe ee eee 


ee we we ee we mo OF ee ee we a ee ee we Oe oe ti ae oe ee ee 


Fixable area [ ! 


Dynamic control blocks | 2K 


ll i ee Oe ee ae ae SS OS OE Se SS Se ee ee a ee Om Oe on a ee tee ae ee ee i i a ee 


1 local writer task with 
one print buffer: 


6084*24*N, 
where 


1° 824 
4 local reader task with 
one buffer: 

576 +2 * WN 

3 execution readers: 

3 * (488 + 608 + 320) 


3 execution writers: 
3 * (448 + 2 * 608) 


or eer oe ee ee ee ee ee i ee ei ee a ee ee SB ee eS Owe we Se we ee ee Ss ewe ee — 


—_ en ee eee wm ee ee ge ee a a ee ee ee a a ee i ee or 


I ! | 
I ! | 
4H | POWER/VS basic modules | | 142K 
| | | 
| I ! 


SLI support 


— oe or > oe wm ee oe we oe ee er ee we ee i ee oe eee ‘casei “cour: hms ents ns aa Sas: amis an elie us a aos ta Ss ae 


First RJE,BSC Line: 
576 + 544 4 120 


1 BSC writer task 


Pe Oe oe oe om me ir OF ee em OF eS ee eee oe ewe we OES SET Pee Be SP eT OO ee ee Se www ewe ew ee ee ew eee 


LLL LLL LL Ly ee eS SS Ee ee ee ee oe a ee ee ee ewes ew a ee ee a 


1 Pageable storage: } I 


~J 


RJE,BSC module | | 16K 


Figure 2-4 (Part 1 of 2). Detailed Storage Calculation Example 
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ee ee ee ee 
|Ref. {Description |Real [Pageable ! 
| {Storage [Storage | 
| } (in bytes) [{(in bytes) | 


ee ew ee me we ee eee ee ee ee ee ee ee ee ee ee ee re er er ee er es Oe er Oe ee ee i ee ee ee we a a ie 


SNA control block 


3770: 
SNA writer task 
(printer, punch, or console) 
SNA reader task (console) 


2 SNA writer tasks 2 304 


(printers and/or console) 


2 SNA reader tasks 2 240 


(reader and/or console) 
3790 (5 sessions): 


4 SNA writer tasks 
(printers and console) 
1 SNA reader task 
(reader) 


—_ 7 ow we ow ee we wr ee ee ae en a ee ee i a ee ee ee ee ee ee eee eee 


] I 
! | 
{ | 
I 1 
I | 
1 | 
I I 
| 1 
| | 
j ! 
} | 
| 3790 (2 sessions): t 
| l 
| ! 
| | 
I | 
! | 
I | 
! I 
! | 
| | 
I ! 
I | 
| | 


= oe we ew oe ew we ee i ee a ee ie ae i aa i ee ewe] ew eee eee 


! Pageable storage: | { 


9 #4 SNA support | | 36K 


= esee ee we ew ewe ew ew ww ew ww & wwe em ee ee wee ee ee ee ee ne a ee oe ww we wwe ee ew es ore 


GETVIS control 
RMCB: {1712 * 3 * 32] 


SUCB, LUCBs: 
(192 + 160 * 5) * 3] 


| 1 
| i 
| | 
! | 
| ! 
I | 
! ! 
! | 
| j 
{ WACBS: | 
1 For 3770: 6K | 
{ For 3790 (2 sessions) 6K ! 
| For 3790 (5 sessions) _ 6K ! 
{ }18K} | 18K 
| I 
i I 
I | 
I I 
| I 
1 ! 


LOGON 
lunames (3790): 


Compaction (1 default): 
1((0.5 *3) * 2) * 2] 

ee | Total GETVIS storage | | 38K 
na a ee I 


ro) 
W 
. 
c+ 
ry 
| ae 
Hh 
° 
A 
wn 
z 
ro 
cr 
a 
a 
» 
un 
od 
N 
~J 
wW 
ron 


Figure 2-4 (Part 2 of 2). Detailed Storage Calculation Example 
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Figure 2-5 is a summary of the detailed storage calculation above. It 
is based on the reference numbers in the leftmost column of Pigure 2-4. 


Ga ol ete ee Ee a ee nk ee ee ee ee ee ee ee ee 
jRef. |Description |Real |Pageable |GETVIS 


ee ee ee ee Oe ee a Ce Owe Se we ew EO BS we eS Oe SB ee we Oe eee ee eee ee 


SS a ee ee eee 


ee ee ee we S&S ee ee ee ee ee es OS eee Oe eB ew ewe we Sew ew we ee Owe wee Se ewe ewe ee eS ee 


| 

| 

| | I ! 

| | t ae 

| J i ! ! 

1 | Permanent I 8K ! | | 
I | I i 1 

2 | Dynamic control blocks |} 2K i | | 
! ! | | | 

3 | Local tasks (in bytes) [{ 12 736 | | J 
| | | | t 

4 | Basic modules ! I 162K I | 
| ! | I | 

5 { SLI support | t 2K | ! 
| | | 1 | 
IRJE,BSC ] ! | l 

! } ! ! ! 

6 | BSC tasks (in bytes) | 2 336 i | ! 
I | | | ] 

7 | RJE,BSC module | ! 16K «4 | | 
I | I I i 
IRORASHA : 

8 | SNA tasks (in bytes) } 12736 f | l 
I | | ! | 

9 ! SNA modules j | 36K | | 
I | ! ! | 

| GETVIS storage | I I 38K J 

ee a ce ee cee ae ee ce we ae me ee ee rs ee te ee ee ee re ee a oe ee re ee ae ne | 
{Total | 38K (*) | 196K " 38K } 

| 

I 


(*) Rounded to the next higher page boundary. 
[a ee a ee | 
Pigure 2-5. POWER/VS Storage Calculation Summary 

For the described example, you must provide the following storage 
allocations for the POWER/VS partition: 

ALLOC: 38K + 196K + 38K = 272K 

ALLOCR: 38K 

The value of the SIZE parameter in the // EXEC job control statement is 
calculated from the ALLOC value minus the size of the GETVIS area; 
hence, for this example, you would have to specify: 


// EXEC POWER ,SIZE=234K 


in the POWER/VS start-up job stream. 
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DOS/VS SUPERVISOR GENERATION REQUIREMENTS 


To include POWER/VS in DOS/VS, you should consider the following before 
generating the DOS/VS supervisor: 


POWER=YES must be specified in the SUPVR macro; it forces PHO=YES and 
NPARTS=3 (if NPARTS was not specified or if NPARTS=1 was specified) 
in the SUPVR macro, and PFIX=YES and ECPREAL=YES in the FOPT macro. 


If POWER/VS accounting support is desired, JA=YES or JA=(n1,n2,...) 
must be specified in the FOPT macro. 


If POWER/VS cross-partition communication support is desired, XECB=n 
or XECB=YES must be specified in the FOPT macro. 


If an IBM 3800 printer is being used, AP=YES must be specified in the 
SUPVR macro. 


If the POWER/VS RJE,SNA support is desired, AP=YES and TP=VTAM sust 
be specified in the SUPVR macro, and one partition must be available 
for VTAM (see the NPARTS= parameter in the SUPVR macro). 


Both the ALLOC and the ALLOCR macros must be used to define the 
POWER/VS partition. Refer to the section "Storage Requirements" to 
determine the appropriate real and virtual storage sizes. 


For the POWER/VS partition, the number of LUB entries for programmer 
logical units must be large enough to accommodate all reader and 
writer tasks that may be running concurrently. The number of LUBs is 
specified in the BGPGR or FnPGR parameter of the IOTAB macro. The 
default value of 5 is not enough: SYS000 through SYS006 are used for 
POWER/VS system files. These system files must be assigned by the 
user. 


The IBM-supplied distribution medium contains a pre-generated 
POWER/VS system that provides the generation parameter default 
functions. 


SPECIAL CONSIDERATIONS FOR DOS/VS FUNCTIONS 


When using POWER/VS, you should be aware of different handling of some 
of the DOS/VS functions: 


In user-written channel command words (CCWs), the following flags are 
not supported: 

Chain data (CD) - xX*80° 

Indirect data addressing (IDA) ~ K*O4!. 


No support is provided for parameter EXCP=REAL. 
Since POWER/VS is designed as an interface between DOS/VS operating 


system and the user's partitions, some DOS/VS commands are affected 
in their usefulness by POWER/VS: 


ALLOCR ( followed by UNBATCH. 


‘ ALLOC beettos using ALLOC or ALLOCR, the PSTOP command must be issued, 


CANCEL Not valid for the POWER/VS partition. 


STOP If STOP is used, a subsequent PSTOP or PEND command will not 
be successful. 
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PRTY Cannot assign the same or a higher partition priority than 
the one in the POWER/VS partition for any POWER/VS controlled 
partition. 


VTAM AND NCP GENERATION REQUIREMENTS 


The DOS/VS Virtual Telecommunications Access Method (VTAM) and the 
DOS/VS Network Control Program (NCP) are required in your DOS/VS 
environment if you plan to use POWER/VS with the optional RJE,SNA 
support. 


For POWER/VS with RJE,SNA, your generated version of VTAM must meet the 
following requirements: 


* Using the APPL definition statement, POWER/VS must be defined to VTAM 
as an application program. The program name must be the same as 
specified as the APPLID subparameter in the SNA= parameter of the 
pertinent POWER macro specification. 


® The password specified in the PRTCT= parameter of the APPL macro, if 
included, must match the password specified in the SNA= parameter of 
the POWER macro specification. 


e The names of the SNA logical units (luname) nust be supplied to VTAM 
through the LU macro instruction. The logical unit names must be the 
same as provided in the PRMT macro as part of the LU= parameter (if 
specified) and in the POWER/VS RJE terminal commands whenever the 
value “luname" is requested. Note: Whenever you are requested to 
specify the parameter "lunase" or the LU macro, you must avoid the 
use of the parameter values EOJ and ALL. 


* Your system programmer may use the facilities provided by the USS 
tailoring services to support a simplified LOGON procedure. However, 
the use of USS depends on the the type of work station: it is 
possible for a 3770, but it is not allowed for a 3790. Complete 
information concerning the VTAM generation requirements is contained 
in the DOS/VS_VTAM System Programmer's Guide, GC27-6957. 


hen using VTAM, you should consider the following: If the buffer limit 
defined for a logical unit has been exceeded, the session with that 
logical unit is terminated immediately without an error message. 
However, this may only occur in an overloaded system. For details, 
refer to the DOS/VS VTAM System Programmer's Guide. 


If you plan to use NCP/VS support in your VTAM network, four NCP modules 
must be link-edited into the core image library. You can use the IBM- 
supplied calling book ISTLINK7 for this purpose. The following job 
stream is necessary to perform this function: 


// JOB LINKEDIT NCP MODULES 
// OPTION CATAL 

INCLUDE ISTLINK7 
// EXEC LNKEDT 


7/& 


This job should be executed after the NCP distribution tape has been 
cataloged to your systen. 
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Generating POWER/VS 


To generate POWER/VS, you must specify parameters of the POWER/VS 
generation macros and subsequently process these macros. This section 
of the manual describes 


The POWER/VS generation macros and their parameters 
The POWER/VS phases and their functions 
The steps required to generate the systen. 


POWER/VS GENERATION MACROS 


The following is a description of the three macro instructions that 
allow you to generate POWER/VS for your particular installation. For 
detailed information on the POWER/VS RJE support, refer also to the 
POWER/VS Work Station User's Guide, GC33-6049. 


The three POWER/VS generation macros are: 


POWER —- for the selection of local support options and for the 
inclusion of SNA support. 

PLINE - for RJE,BSC support {in addition to the POWER and PRMT macros). 

PRMT - for RJE,BSC or RJE,SNA support (in addition to the POWER and 


PLINE macros, if applicable). 


Conventions 
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Uppercase letters, numbers, and punctuation marks must be coded 
exactly as shown. 


Operands can start in any column after the operation code and one 
blank space. A card can contain more than one operand. 


Lowercase letters and words represent information that must be 
supplied by the programmer. 


Options contained in braces { } represent alternatives, one of which 
must be chosen. 


Brackets [ ] indicate that the element they enclose is optional. 
Stacked options contained within brackets 


A 

B 

represent alternatives, one and only one of which may be chosen. The 
brackets themselves are for descriptive purposes only, and must not 
be coded. 

Default values are underlined. 


No comma is used before the first parameter specified. 


Keyword parameters consist of a keyword, followed by one or more 
values. 


Positional parameters must appear in a specified location, relative 
to other parameters. 
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POWER Macro 


seam 


The POWER macro and its parameters are sufficient to generate a non~RJE 
system. With the parameter SNA= (see below), this macro also provides 
support for an RJE,SNA system. Por an RJE,BSC system, the PLINE and 
PRMT macros are required additionally. In an RJE,SNA environment, the 
PLINE macro does not apply; but the PRMT macro must be used. These 
macros are described later. 


|Name jOperation ere |Col |} 
= ch 
|POWER |POWER an } 1C*31 
Jname | ! ! 
It TRACKGP=f0\J real 
i | es, rt 
! | I{ »-LTAB= [(10,00,05,10,15,20,25, 30,35,40, IC *II 
t t | (40,d1,d2,423,04,45,d6,d7,a8,a9, { } 
! I | 45,50,56)_ __\J Ic*JI 
t | | d10,d11,d 12) j i 
! I | i of 
| MC -PRI=/3\) Icy 
' ! } n 1 4 
| [ | | 
| j I{ ,SUBLIB=fNO\} edt 
| l | + rot 
! | | bol 
| ! If ,ACCOUNT= } Ie 
| | | = 1 ot 
{ 1 i od 
l | I{ -STDLINE=f{0,0)) J 1*J1 
! ! ! (n,m) | 
I { ! 1 ot 
I ! I{ ,-STDCARD= £(0,0))]J 1 *31 
| { { cay - Pp 4 
! | { 1 ot 
| If ,JLOG=fYES Ic*I1 
! j | ah i oo] 
i | t | 
| | ase terry J 1*Jl 
! ! ! (n,m) rot 
! | | rf 
1 | If -RBS= [(0,0)\J 1*]I 
[ | | (n,m) | 
| ! | 1 4 
| { Ie a J I*JI 
| l t nane ! | 
| 1 ! ' | 
l [ Wid 1c*dt 
| | | YES I | 
! ! | | 
t ! | Iced 
| | r 4 


vas 
Ohne rr a a s-seb P>PS> S- S SS o-csneoe-wecnmasl 


(continued on next page) 
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continued: 


|Name JOperation |Operands {Col { 
! | 172 
| | IL »SNA=([f wscount J,{ password } 1 *)] 
! } I no, PRMT with LUTI ! { 
| | | Jeers | i 
! ! I ! 1 
| l | 1 1 
! ! If -FEED= a Ic*J! 
| 1 | NO ! | 
| | ! ! ! 
| | If -MULT12 ie fC 1C*]] 
| I | 1 | 
| ! | ! | 
| ! I{ ,COPYSEP= iy ic*7] 
| | ! ! i 
! | { I 1 
| I[ ,CLRPRT= gta a IC *JI 
| | ! | | 
! I ! | I 
} I {( -MRKPRA= ~{ees\) I } 
| i | I | 
het enon ths srs pps SNS | 
Programming Notes: 

name specifies the phase name to be included in the PHASE card 


generated as the first card in the object deck resulting 
from this assembly. The phase name consists of 1 to 7? 
alphameric characters, the first of which must be 


alphabetic. 
If no name is specified, the name POWER is assumed as 
default. 

DBLK= specifies the block size of data file records (both disk 


and tape) and, conseguently, the size of each data 
buffer. Data buffers are used as I/0 areas by the 
execution processors, readers/writers and RJE routines. 
The value n must be an integer from 544 to 2008; however, 
if you have IBM 3211 printers installed and wish to use 
the * $$ LST (* $$ PRT) statement with the UCS parameter 
option, the value n must be an integer from 608 to 2008. 
If DBLK is omitted or set to 0 and a cold start is 
performed, the system assumes a block size appropriate to 
the device type used for the data file, which is shown 
below: 


ce 


|Device Type jData Block Size 1 
ewe w ee eww ee oe www we em ee een wwe ew eo eee | 
12314 | 920 t 
} 3330 | 952 ] 
{3330 Model 12 | 952 j 
13340 | 808 | 
}3350 | 960 | 


Note: When you are generating two or sore POWER/VS 
systems and plan to transport disk or tape intermediate 
Storage between the systems, you must specify identical 
block sizes in all these systems to avoid block size 
incompatibility problems. 
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TRACKGP= 


LTAB= 


PRI= 


SUBLIB= 


ACCOUNT= 


specifies the number of tracks in a track group. A track 
group is the amount of disk space that POWER/VS allocates 
upon a request for space by any POWER/VS routine. The 
value n may be any integer from 1 to the number of tracks 
on a cylinder of the device assigned to the data file. 

If the TRACKGP parameter is omitted or set to 0 {or if 
conflicts are detected during initialization) and a cold 
start of POWER/VS is performed, the system calculates a 
Suitable track group size. Shen a warm start is 
performed, the track group size established at the 
previous cold start is used. 


Note: The maximum number of track groups is the number 
of track groups per cylinder times the number of 

cylinders. The number of track groups per cylinder is 
the number of tracks per cylinder divided by the track 


group number. The remainder is ignored. 


describes the forms control tape or the forms control 
buffer of the printers. If LTAB is specified, all 
entries in the sublist (d0 through 412) must be present. 
Each entry is specified as two digits. The sum of dO and 
at2 is considered to be the page depth (= number of print 
lines on each page). If channel 12 is not specified 
(d12=00), the value specified by dO is taken to be the 
page depth. 


Note: For FCB printers POWER/VS will load the default 
PCB if none is specified. The LTAB used for the current 
POWER/VS job will be updated by the FCB load routines, 
but the value specified here will remain in effect as 
long as POWER/VS is active. 


specifies the default priority of a job entry when a 
priority is not specified in the * $$ JOB statement. The 
value n may be any digit from 1 to 9, where 9 is the 
highest priority. If PRI is not specified, the default 
value is 3. 


specifies the sublibrary of the source statement library 
to be searched when the sublibrary is not specified in 
the * $$ SLI statement. The value s may be A through Z, 
0 through 9, $, #, or @®. You should note, however, that 
sublibraries A, C, D, E, F, and Z are already special- 
purpose libraries in DOS/VS. If omitted or if SUBLIB=NO 
is specified, SLI statements will be treated as data. 


specifies whether POWFR/VS is to maintain accounting 
information. If NO is specified, no POWER/VS accounting 
information is maintained. If YES is to be effective, 
the DOS/VS supervisor must support the job accounting 
interface (see the JA parameter in the FPOPT macro). All 
accounting information is stored in the POWER/VS account 
file IJAFILE. If you want job accounting while POWER/VS 
is active, you should specify ACCOUNT=YES in order to get 
a correct SIO count. 
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STDLINE= 


STDCARD= 


JLOG= 


JSEP= 


h specifies the number of list records that may be 
printed for a job entry before a warning message is 
issued to the operator. m specifies the additional 
humber of list records that may be printed before the 
same message is reissued. Both n and m may be up to 6 
digits. 


A specification of 0 means that no warning will be given. 
If one of the entries is omitted, the value provided is 
used for both entries, as shown in the example below: 


STDLINE=({,800) generates STDLINE= (800,800) 
STDLINE=(10000) generates STDLINE=(10000, 10000) 
STDLINE=12000 generates STDLINE= (12000, 12000). 
If STDLINE is omitted, (0,0) is assumed. 


n specifies the number of records that each job entry may 
punch before a warning message is issued to the operator. 
m specifies the adtitional number of records that may be 
punched before the same message is reissued. Both n and 
m may be up to 6 digits. 


A specification of 0 means that no warning will be given. 
If one of the entries is omitted, the value provided is 
used for both entries in the same way as shown for 
STDLINE. If STDCARD is omitted, (0,0) is assumed. 


specifies whether POWER/VS is to display each jobnane 
together with the job number whenever a * $$ JOB 
statement is read in a partition under POWER/VS control. 


If YES is specified, all such statements will be logged 
on the system console (SYSLOG). If NO is specified, no 
such logging will take place. If this parameter is 
omitted, JLOG=YES is assumed as default. 


specifies that special pages or cards be included in the 
output to separate job entries. nh specifies the number 
of separator pages. m specifies the number of separator 
cards. nm and m may be any digit from 0 to 9. The 
minimum number of separator cards is 3. For print 
output, one additional page as specified by n will be 
printed. If JSEP is omitted, (0,0) is assumed. 


The JSEP specification can be overwritten by a JECL 
statement for a particular job. 


Note: Stacker selection is ignored if job separation is 
reguested. The default stacker for the given device is 
used instead. 


Separator pages are printed with the line depth in effect 
during job execution. The line depth is obtained from 
either the printer forms control buffer {FPCB) or from the 
LTAB values in effect at that time. If the page size 
differs from the line depth, the printout will not be in 
the correct format. 
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RBS= 


RDREXIT= 


PAUSE= 


SPOOL= 


SNA= 


specifies the number of list pages (n = number of skips 
to channel 1) and the number of punch cards (m = number 
of cards) that can be processed before the output is 
segmented. This parameter is used only when spooling to 
@isk intermediate storage. n and m may be from one to 
six digits. A specification of 0 means that no 
segmentation will take place. If RBS is omitted, (0,0) 
is assumed. This parameter is ignored when DISP=T is 
specified in the * $$ LST (* $$ PRT) or * $$ PUN command. 


Note: For segmentation on a 3525, and when using print 
commands, all segments must be punched in a row, or 
separator cards must be specified. This avoids loss of 
the last two print lines. 


specifies whether a user-written POWER/VS reader task is 
supported. Upon initialization of POWER/VS, the phase 
with the name specified in the RDREXIT parameter is 
loaded into the POWER/VS partition. If this parameter is 
omitted, it is assumed that no user-written reader task 
exists. 


For a detailed description of the reader exit routine 
refer to Appendix E. 


specifies whether a punch writer task is to wait before 
every punch job entry. If NO is specified, the punch 
writer task will not wait. This is also the default 
assumption if this parameter is omitted. If PAUSE=YES is 
specified, the punch writer task will cause message iQ40A 
to be displayed before each job entry. Punched cards can 
then be taken from the stacker of the punch device. To 
reactivate the writer task, issue a PGO command. 


If YES is specified, the POWER/VS cross-partition 
communication macros PUTSPOOL, GETSPOOL, and CTLSPOOL are 
supported. If NO is specified, no interface is 
supported. This is the default assumption. If 
SPOOL=YES, then XECB support must be specified in the 
supervisor. 


specifies parameter values for the POWER/VS RJE,SNA 
support. The meaning of the positional subparameters is 
as follows: 


of the GETVIS pool size for SNA work station control 
blocks (SUCBs, LUCBs). The GETVIS pool size is 
calculated and the space reserved during POWER/VS 
initialization. 


Any value from 0 to 200 may be specified. When coding 
this operand, consider the following: 


1. A default value of 0 is assumed if this operand is 
omitted or invalidly specified. In this case, the 
GETVIS pool size is calculated from the total number 
of SNA work stations and the largest SESSLIM= value 
specified in the PRMT macro. The largest SESSLIN= 
value is used to avoid fragmentation. 
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MULTI2= 


2. If a value is specified that is smaller than the 
total number of work stations defined in the PRMT 
macro, this wscount value is taken during POWER/VS 
initialization to calculate the GETVIS pool size for 
SUCBs and LUCBs. This smaller wscount value can 
limit the number of work stations and sessions that 
can log on concurrently because the GETVIS pool size 
is reduced. The limitation depends on momentary 
system conditions. 


3. If a value greater than or equal to the number of 
work stations defined in the PRMT macro is specified, 
the information in the PRMT macro is used to 
calculate the GETVIS pool size. 


Password - This specifies the password (1 to 8 
characters) to be used by POWER/VS when it issues an OPEN 
call for a VTAM ACB. This password nust be identical to 
the password specified in the PRTCT operand of the VTAM 
APPL statement. If no password was specified in the 
PRTCT operand, the password specified in the SNA 
parameter is ignored during POWER/VS execution. 


apolid - This identifies the POWER/VS application name 
used to establish the VTAM API. This name must be 
identical to the name specified to VTAM during the VTAM 
generation. If this subparameter is omitted, the name 
POWER is assumed as default. 


Note: If you want to omit subparameters of the SNA= 
parameter, you must substitute each omitted subparameter 
by a comma unless the omission occurs at the end of the 
parameter list. 


Examples: 
SNA=(wscount, ,applid) 
SNA=(, ,applid) 

SNA= (wscount) 
SNA=(wscount, password) 


determines the POWER/VS default to eject the previous and 
feed a new 3540 diskette at end-~of-file of the previous 
one. This default may be overridden by a JECL statement. 


provides the option for the repeated posting of the 
printer channel 12 condition on each page to offer 
compatibility for DOS/VS POWER users. 


The repeated posting of channel 12 (also referred to as 
multiple channel 12 posting) means that once channel 12 
has been reached, each subsequent line being printed on 
the same page will signal the channel 12 condition to the 
user program until channel 1 has been reached. 

If MULT12=NO is specified explicitly or by default, the 
channel 12 condition is indicated to the user program 
only once when channel 12 has been reached, but not when 
subsequent lines are printed on the same page. 

Multiple channel 12 punches may be specified in a FCB 
phase, however only the last channel 12 location will be 
recognized. 


Note: If MULT12=YES is specified for an PCB-type printer 
program output may be different from that output, 
received when running under DOS/VS, not using POWER/VS. 
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COPYSEP= 
CLRPRT= 3 
MRKFRM= 3 


specifies whether POWER/VS should produce separator 
pages/cards between each copy of an output file. If NO 
is specified, the separator pages/cards are suppressed. 
If YES is specified, separator pages/cards are included 
between each copy of an output file. However, copy 
separation is done only for a nonzero JSEP specification, 
defined either during POWER/VS generation or in a JECL 
statement. 


If this parameter is omitted, COPYSEP=YES is the default. 
The COPYSEP specification can be overridden by a JECL 
statement. 


specifies whether POWER/VS is to clear the page buffer of 
the IBM 3800 Printer at end of job and is to wait until 
printing of the job is complete. If NO is specified, 
POWER/VS begins to fill the page buffer with the next 
job*’s output without waiting for completion of the 
printing of the previous job. If YES is specified, the 
page buffer of the 3800 is cleared at end-of-job. If 
this parameter is omitted, CLRPRT=YES is the default. 


Note: If you specify CLRPRT=NO, be aware that if an 
error occurs on the 3800 while printing the previous job, 
the result may be incomplete. The previous job would 
already have been degqueued according to its disposition 
and POWER/VS is not able to reprint any lost data. 
However, if you define the disposition K in the * $$ LST 
statement, the output remains in the LST queue after 
processing. After verification that the output is 
complete, the operator can then delete the output job 
from the queue. 


Specifying CLRPRT=YES may degrade performance of the 
3800, because the printer must wait for the page buffer 
to be emptied. 


specifies whether the Mark Form function of the IBM 3800 
Printer is used when producing job separator pages. If 
NO is specified, POWER/VS includes job separator pages 
according to the number of separator pages specified 
during POWER/VS generation or in the JECL statement. If 
YES is specified, POWER/VS creates only one separator 
page and then issues the Mark Form channel command, which 
causes a row of dark marks to be printed on the 
perforation between pages. The 3800 reproduces either 
three or five copies of the separator page (depending on 
the page size) with the black marks printed on the 
perforations. The printer then produces a sufficient 
number of blank pages to advance the last row of black 
marks beyond the fuser station. 


The MRKFRM option is activated only when job separator 
pages are to be printed. If the parameter is omitted, 
MRKFRM=YES is the default. 


POWER/VS uses the Mark Form function of the 3800 only 
when producing start separator pages. (The separator 
pages between copies are also considered as start 
Separator pages.) When producing end separator pages, 
POWER/VS reprints the separator page according to the 
JSEP specification. 


(27} Operand is valid only for the IBM 3800 Printer. 
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PLINE_Macro 


The PLINE macro instruction and its parameters define the hardware 
characteristics of an RJE,BSC line, that is, the integrated 
communication adapter or the control unit. The PLINE macro({s) must 
follow the POWER macro and precede the PRMT macro(s). 


One PLINE macro must be specified for each line. Up to 25 RJE,BSC lines 
are supported by POWER/VS. 


|Name [Operation |Operands }Col | 
| | {72 | 
| |PLINE | ADDR=X*cuu® 1 *TI 
| | | 1 | 
| | IL ,SWITCH=JNO | J 1c * Tt 
I | | YES | ! 
| | i ! | 
i TINEOUT= {0} ] 10*7] 
| | | n ! | 
| | | | | 
| l I{ -PSWRD=password } 1G *J1 
1 ! | ! | 
i i + TRESP= (7851 *TI 
I ! | NO I ! 
| | | } | 
| | If ,CODE=JEBCDIC \] IC * JI 
| i j ASCII ! " 
| | I | | 
| | | AA I I 
| } I{ ,MODSET=J AB IY | | 
! I | BA | ! 
I | I BB | I 


ee eh ee ee ee ee ee ee 


ADDR= 


SWITCH= 


TIMEOUT= 


specifies the line address (channel and unit number) of 
the control unit. This address is the same as used to 
identify the control unit to DOS/VS. This parameter is 
required. Although hexadecimal notation is not required, 
note that a decimal address will be converted to 
hexadecimal (that is, 030 is assembled as X*0O1E*). 


specifies whether a switched or leased line connection is 
being used. A specification of SWITCH=NO indicates 
leased line operation, which is the default assumption. 
SWITCH=YES indicates switched line operation. 


specifies the number of minutes the terminal is allowed 
to remain idle before SIGNOFF is forced. The value n may 
be any number from 0 to 255. If NO is specified or this 
parameter is omitted, the terminal is allowed to remain 
idle for three minutes. This parameter is useful to save 
line charges on switched lines. 


Note: Forcing SIGNOFF to an inactive terminal is not 
only desirable because the terminal may be keeping a 
switched line busy, but also because the CPU is then 
processing timeouts every three seconds. in such a case, 


the user may be charged for unused line or CPU time. 
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PSWRD= specifies the security password to be submitted by the 
remote operator whenever he wants his terminal to be 
connected to the central system. The password may be up 
to 8 characters in length. It may be overridden (until 
the next PSTOP command) by the central operator via the 
PSTART command. 


TRNSP= specifies the transparency feature on the integrated 
communication adapter or the transmission control unit. 
This feature is required for transmission of object 
decks. 


NO may be specified only if no object decks are to be 
transmitted over the line. All data characters between 
X'O00* and X*40* are then converted to zeros, when 
transmitting to the terminal. 


CODE= specifies the transmission code, which may be either 
EBCDIC or ASCII. 


MODSET= Specify this parameter only when uwSing a 2701 control 
unit. The first character of the operand specifies 
Interface A or B, when a dual communication interface is 
used. The second character specifies code A or B, when 
the Dual Code feature is installed. Refer to the 
component description of the IBM 2701 Data Adapter Unit, 
GA22-6864, for more details. 


PRET Macro 


The PRMT macro and its parameters define the hardware characteristics of 
an RJE terminal, identify the user, and describe where his output is to 
be routed. At least one PRMT macro must be supplied for each user, and 
all PRMT macros must be supplied after the PLINE macro(s), if present. 
The PRMT macros must be specified in ascending sequence according to 
their remote-IDs (see the REMOTE= parameter below), and the definitions 
for non-SNA remote-IDs must precede the definitions for SNA remote-IDs. 
If any feature is specified for a terminal on which the feature is not 
supported, the parameter is ignored. 
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}Name [Operation [Operands Used in JCol}] 


| | | }72 ! 
| som eee em Oe ee Oi Oe ie ee ee ee Oe Oe ee ee ee oe ee Om er On OO os im le ee On OO OOS SS OBS BOOSTS DOD 

j{{ name JJ PRMT } REMOTE=nnn, SNA,BSC } * | 
| | | 1 | 
| | | 2770 | I 
! | | 2780 | ! 
| | } TYPE=<(3741 SNA,BSC |[*]} 
| | | 3780 I | 
I | | LUT 1 ' | 
| | | i 
t | I{ ,LSTROUT=fremid J SNA,BSC |[ *}] 
I | | non ! | 
| | | 1! | 
} | I( »PPUNROUT= eae SNA,BSC |[*]] 
| | | is ! i 
/ { | | | 
| } If -REF=mmn } SNA,BSC {{ *]] 
| t I | | 
| | I{ ,CONSOLE= ao f SNA I*IJI 
! I | | l 
| | | t ! 
| | I{ -PSWRD=passvword ] SNA If * JI 
| | | | | 
! | If -SSESSLIM=f[n)\] SNA *TI 
| | | 1 ! ! 
I | | t 
| | If ,CMPACT=name J SNA if*4 
I I t ! 
{ | {{ ,LU=(name,name,name,...) ] SNA It * JI 
| | t 1 
I | } 80 I | 
| | If -LIST=]|132 |J BSc |I[{*]} 
! | | 14 ! 
I | | 129 ! | 
} | | ! ! 
i | If -TRNSP= Be Bsc I[ *}] 
I | j YES t | 
! t | | | 
! | I{ ,-BE= ing BSC i{*]J] 
| I ] I | 
l I ] I | 
| i I ,-HPC= a a Bsc 1(*Jl 
| ! | | I 
| J | | I 
| ! J{ ,SCE gtk e BSC {I{*]t 
] 1 | ! ! 
| | | | | 
| | I{ ,-ABE “aot BSC |[{*JI 
| | I I | 
! | | ! I 
| | If -MRP= 7 J BSC {{*JI 
I | | | | 
| | I ! | 
| | If »cs aan J BSC I[*Jl 
! | | ! | 
t / | I | 
| | If -eTRACE Pfr BSC | | 
| | | ! | 


Mn err cr 
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If the terminal characteristics of a given terminal or work station to 
be described by a PRMT macro are identical to those specified in a 
preceding PRMT macro instruction, a short form of this macro may be used 
(see also the explanation for the REF parameter). The short form of the 
PRMT macro includes the following parameters: 


{Name [Operation [Operands Used in [Col] 
! } ! }72 | 
I{ nase J{PRMT } REMOTE=non[ name ] SNA,BSC [[*]] 
| ! i | } 
| | aaa (a ? SNA,BSC {[*}l 
! I | non I ! 
I | l ' 
! I ica eg J SNA,BSC [[*]| 
! ] | nnn . | | 
1 1 | 1 ! 
I j I( -REF=nmmn j SNA,BSC | { 

= | 


REMOTE= specifies the remote-ID ("remid") identifying an RJE 
terminal (BSC terminal or SNA work station) to which the 
specifications apply. The valve nnn is a decimal integer 
in the range from 1 to 200. The first remote-ID should 
be specified as 7; any succeeding remote-IDs must be 
incremented by 1. The lowest SNA remote-ID must be 
greater than the highest BSC remote-ID. All following 
SNA remote-IDs must be in consecutive ascending order. 


Note: If REMOTE=1 is specified, the parameter REF= 
cannot be used. 


TYPE= specifies the type of terminal, which may be a 2770, 
2780, 3741, 3780, or an SNA terminal. For 3770, svecify 
TYPE=2770 or 3780 depending on the buffer size. For SNA 
support, the terminal must always be specified as LUT1. 


LSTROUT= specifies where the list output from jobs submitted by 
this remote-ID is to be routed by default. If this 
parameter is omitted, the same remote-ID as specified in 
the value nnn of the REMOTE parameter is assumed. 


PUNROUT= specifies where the punch output from jobs submitted by 
this remote-ID is to be routed by default. If this 
parameter is omitted, the same remote-ID as specified in 
the value nnn of the REMOTE parameter is assumed. 


| REF= specifies the remote-ID. of another PRMT macro, which 
describes the terminal or work station characteristics of 
this PRMT macro. The value mmm can be any integer lower 
than the value nnn used in the REMOTE parameter. ‘mmm! 
can therefore be in the range from 1 to 199, 


Parameters other than REMOTE=, LSTROUT=, and PUNROUT are 
ignored when specified in a PRMT macro with REF=nnn. 
MNOTE statements in the Assembly listing inform you about 
this fact. 


Note: Check the referenced PRMT macro instruction for 


correct assembly. No warning is issued in the referring 
macro if the referenced macro is in error. 
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CONSOLE= 


PSWRD= 


SESSLIM= 


CMPACT= 


LU= 


may only be specified for an SNA work station and only if 
this work station has a line printer in addition to the 
normal terminal console. 


YES causes PGWER/VS to interrupt the outbound printer 
flow whenever messages are generated for the remote 
operator unless a free session is available with the work 
station (MLU environment only). For multiple logical 
units, messages are always sent when a free session is 
found, regardless whether or not jobs are being 
transmitted, even if CONSOLE=NO is specified. 


Por single logical units, NO prevents POWER/VS from 
interrupting an outbound printer flow for the 
transmission of messages to the remote operator. In this 
case, the messages are collected and submitted to the 
operator after POWER END OF JOB has been reached. 


If the SNA configuration does not contain an additional 
line printer and CONSOLE=YES has been specified, the 
printout will contain interspersed messages to the remote 
operator. 


If this parameter is omitted, CONSOLE=NO is assumed as 
default. 


Note: For the 3790, CONSOLE=YES should always be 
specified. 


specifies the security password that may have been 
defined for the remote work station being described. The 
password must match the password contained in the user 
data of the LOGON command. If the password is invalid, 
it is set to blanks, and an MNOTE statement will appear 
in the Assembly listing. 


specifies the paximum number of sessions that may be 
logged on by an SNA work station. Any value from 71 to 6 
May be specified. 


If this parameter is omitted or invalidly specified, the 
value 1 is assumed as default. 


specifies the default name of the compaction table to be 
used for a work station if no compaction table is called 
for in the * $$ LST or * $$ PRT statement. Data 
compaction can be requested by means of a JECL statement 
even though no compaction was selected originally, either 
by default or explicitly. The name of the compaction 
table may be up to 4 characters long; the first character 
must be a letter (A through Z) or a $, a @, or a #. 


specifies a list of secondary logical unit names that may 
log on using the remote-ID specified in the REMOTE= 
parameter. These names must be specified in accordance 
with the definitions for VTAM. If this parameter is 
specified, LOGON requests for a given remote-ID will only 
be accepted if the name of the logical unit attempting to 
log on appears in the list of logical unit names for this 
remote-ID. If the name is not contained in the name 
list, the LOGON request is rejected. 
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LIST= 


TRNSP= 


HFC= 


TRACE= 


If this parameter is not specified, no logical unit name 
test is performed during the LOGON procedure. 


Note: The number of names to be specified for one 
renote-ID may be larger than the number specified in the 
SESSLIM parameter. The number of logical unit names is 
only limited by the DOS/VS Assembler restrictions. 


specifies the number of print positions in a line. Any 
number can be used from 80 to 150. The maximum value is 
that of the maximum number of print characters per line 
of the printer. The following maximum values of LIST 
apply: 144 for the 2770, 2780, and 3780; 126 for the 
3741. 


Note: Por the 2770 and 132 print positions, the buffer 
expansion feature is required and must be specified with 
the parameter BE=YES. 


specifies the transparency feature on the terminal. This 
feature is required for the transmission of object decks. 


NO may be specified only if no object decks are to be 
transmitted to this terminal. All data characters 
between X'OO* and X*'40* are then converted to zeros, when 
transmitting to the terminal. 


specifies buffer expansion, which applies to the 2770 
only. The size of the buffer is then 256 bytes. 


BE=YES or ABE=YES are necessary if LIST=132 is specified, 


specifies horizontal format control on the 2770 and 2780. 
Horizontal format control is a standard feature of the 
3780; a specification of HFC, irrespective of the operand 
(NO or YES), is ignored. 


Note: If HFC and SCE are both specified, HFC is ignored. 
specifies space compression/expansion, which applies to 
the 2770 and 3780 only. 


specifies additional buffer expansion for the 2770. The 
size of the buffer is then 512 bytes. 


specifies the multiple record feature for the 2780 only. 


specifies the component selection feature on the 3780 
terminal. Required if a 3781 punch is connected to the 
3780. 


specifies that all I/O interrupts and timeout records for 
RJE,BSC lines are to be traced for this terminal as soon 
as this remote-ID signs on. For more information on this 
I/O trace, refer to the DOS/VS POWER/VS Logic manuals, 
SY33~-8576 and SY33-8577. 
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Following are two examples of macro definition sequences for the 
generation of POWER/VS systems. 


POWER with RJE,BSC and RJE,SNA support: 


POWER SNA= (3) UP TO 4 WORK STATIONS MAY BE LOGGED 
ON CONCURRENTLY 
PLINE ADDR=x*cuut DEFINES BSC LINE 
PLINE ADDR=x'cuu' DEFINES BSC LINE 
PLINE ADDR=x'cuu’ DEFINES BSC LINE 
PLINE ADDR=x'cuu' DEFINES BSC LINE 
PRMT REMOTE=1, DEFINES BSC REMOTE 
TYPE=2 780 
PRMT REMOTE=2, DEFINES BSC REMOTE 
TYPE=2770 
PRMT REMOTE=3, DEFINES BSC REMOTE 
TYPE=3780 
PRMT REMOTE=4, DEFINES BSC REMOTE 
TYPE=2770 
PRMT REMOTE=5, DEFINES SNA REMOTE 
TYPE=LUTTI, 
CONSOLE=YES 
PRMT REMOTE=6, DEFINES SNA REMOTE 
TYPE=LUTT, 
CONSOLE=YES 
PRMT REMOTE=7, DEFINES REMOTE 
TYPE=LUTI, 
CONSOLE=YES, 
SESSLIM=4, 
CMPACT=TEXT 


Example 2. POWER with RJE,SNA support only: 


NAME2 POWER SNA=(3,, POW) 
PRMT REMOTE=1, 
TYPE=LOUT1, 
CONSOLE=YES, 
SESSLIM=5 
REMOTE=2, 


TYPE=LUT1, 
CONSOLE=YES, 
SESSLIM=2, 
CMPACT=TEXT, 
LU=(LU01,L002) 
REMOTE=3, 
TYPE=LUT1 


PCPTAB Macro 


By means of the PCPTAB macro, you define a compaction table set for the 
POWER/VS SNA support. Any number of compaction tables may be generated 
for a specific POWER/VS installation; they are identified and referred 
to by their names. 


Compaction tables need not be generated during the POWER/VS system 
generation. They can be provided at any time, aS required. For more 
information on compaction tables refer to "Data Compaction" in 
Appendix A. 
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To code the parameters of the PCPTAB macro correctly, consider the 
following: 


The maximum length of a character string defined as an operand of a 
Systen/370 Assembler instruction is 255 bytes. This means that, in the 
80-column card image format, the operands of the NOMASTn parameters may 
have to be continued in subsequent continuation cards pertaining to the 
same parameter. Any card that is to be continued on a subsequent card 
must have a nonblank continuation character in column 72. The asterisks 
shown below (in brackets) in column 72 of the macro format description 
indicate that new parameters may follow. 


SR a ana a a A a a a a a | 


|Name [Operation |Operands jCol] 
aaae |PCPTAB | MASTER=(mc1l,...,2c16) C4 
i Cgmon NS RAKdheeaNst oo. see IIS ot 
| IC -NONAST2= (nmc (n*1),.-.,nmc(p)) J IC*II 
; i 


I{ ,-NOMAST3= (nmc (p*+1),..-,nmc (q)) ] 


name specifies the symbolic name of the compaction table. The 
Rame may be from one to four characters long; the first 
character must be alphabetic (A-Z, $, ®, or #). During 
POWER/VS generation, this name will become the phase name 
of the default compaction table. If no name is 
specified, PCPT is used as the name. 


MASTER= specifies the set of master characters. From 3 to 16 
master characters may be specified. For details 
concerning the selection of master characters, refer to 
Appendix A. The master characters can be specified as 
character or hexadecimal values in any sequence, 
separated by commas; for example, MASTER=(A,B,40,D,7F). 


NOMASTn= specifies the set of non-master characters. The number 
of non-master characters to be specified depends on the 
number of master characters defined in the MASTER= 
parameter. If m is the number of master characters and 
hm the required number of non-master characters, then 


0 


8 If m = 16, then nao 


e If a < 16, then no 256 - m(m*1). 

For details concerning the selection of non-master 
characters, refer to Appendix A. The non-master 
characters can be specified as character or hexadecimal 
values in any sequence, separated by commas; for example, 
NOMAST1= (X,N,3A,1C,B0,H). 


The maximum length of the character strings that may be 
specified in the NOMSTn= parameters is 255 bytes, 
including the separating commas and the enclosing 
parentheses. However, you may continue the non-master 
character specifications of, for example, NOMASTT= by 
using the NOMAST2= parameter even though the maximum 
string length in NOMAST1= has not yet been reached. 
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A number of rules apply for the character specifications of the MASTER= 
and NOMASTn= operands. These are: 


A master or non-master character must not be specified more than 
once. 


The following characters, if specified as master or non-master 
characters, must be enclosed in single quotes when specified in 
character notation in the respective operands: 


= Left parenthesis: ee or hexadecimal 4D 
ad Right parenthesis: ‘')* or hexadecimal 5D 
= Comma: Le or hexadecimal 6B 
” Blank: ae or hexadecimal 40. 


The following characters, if specified in character notation as 
master or non-master characters, must be specified twice while they 
count as one; 


= Ampersand: && or hexadecimal 50 


- Quote: ee or hexadecimal 7D. 


For performance reasons, forms~feed and new-line (FF (X'0C*) and NL 
(X*15")) characters should be specified as non-master characters. 
Select-channel characters (SELn or X'04* and SEL2 through SEL12 or 
X*82* through X*7C*) and the carriage*return (CR or X*'OD*} character 
should be specified as required. (Refer to "Outbound Print Data" in 
Appendix A). 


After assembly, the resulting object module must be link-edited and 
cataloged in a core image library (system or private) with the phase 
name specified in the name field of the PCPTAB macro. 
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POWER/VS PHASES 


The system coffe image library of the DOS/VS system contains one version 
of POWER/VS, which is generated with default values for all macro 
options and is cataloged under the phase name POWER. The names of the 
phases that constitute POWER/VS are listed in Pigure 2-6, 


Co ne ee ee eT ee pe ee ee 
Phase Name | Function | 


a a et tn re ees rteeeennee~| 


a 


| 

| SSBPOWIN |} Initialization and termination | 
| SSBSGMNT } Output setup for unit record (macro-called) ! 
{| IPWRSSAQ { Add to queue | 
| IPWSSAS } Asynchronous service function (for 3800 printer only) | 
| IPpwS$epP | Command processor | 
| IPWSSDD { Display POWER/VS files | 
{| IPwSSDO | Delete from queue t 
{| IPWSSER | 3540 physical reader 1 
| IPWSSFOQ | Free queue | 
| IPWSSGA | Get account record | 
j IPNSS$GD | Get data record | 
Jj IPwWSS$IB |} Inbound processor | 
| IPwWS$IC | Initiate command processor } 
] IPWS$I1 | Initialization | 
| IPW$$I2 { Initialization | 
| IPRSSLF | Logoff processor ] 
| IPWSSLH | SNA logon processor 1 } 
| IPWSSLN | SNA logon processor 2 ] 
| IPWSSLR } Logical reader | 
| IPWS$LU | LUB and PUB routines | 
{ IPWSSLW }| Logical writer | 
| IPWSS3MD | Message definition | 
{ IPWSSMP | Message processor | 
{| IPWSSMS ] Remote message handler | 
| IP#@S$NOQ | Next from queue } 
{ IPWSSNU } Nucleus l 
| IPWSSOB |} Outbound processor | 
{ IPwSsoc | Outbound compaction | 
| IPWS$OE | Open 3540 | 
| IPwHSSor | Open tape | 
} IPWSS$PA | Put account record | 
} IPWS$PD {| Put data record [ 
| IPWS$PL | Physical list | 
| IPWSSPP { Physical punch I 
|] IPWSSPR } Physical reader | 
| IPwS$$Ps | Print status report j 
| IPWS$RO | Reserve queue | 
| IPWSSSA |} Save account record | 
| IPws$sc ) Scan and check parameter | 
| IPWSSSL | Get source library record | 
{ IPWSSSM | Spool management ! 
{j IPWS$SN } SNA manager } 
| IPWSSTM ! Remote job entry | 
| IPWSSTR } Task termination | 
| IPWSSVE } VTAM exits { 
| IPWS$xI | Execution JECL analysis | 
| IPWS$XR | Execution reader ] 
| IPwS$xw | Execution writer | 
| POWER | Minimum POWER/VS system ! 


Figure 2-6. 
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POWER/VS GENERATION PROCEDURE 


This section describes four steps for generating POWER/VS: 


1. Select the various macro options as required. For this purpose, use 
a copy of the coding work sheet illustrated in Figure 2-7 to record 
your choices. 


2. Assemble the POWER/VS generation macros, which create the POWER/VS 
generation table. The resulting object module contains the code 
necessary to invoke the POWER/VS initialization module. 

3. Link-edit the object module to the system core image library. 

4. For ease of serviceability, check if the translating system dump 
transients are still in the core image library. 


After generation, POWER/VS can be initialized by the start-up procedures 
described in Chapter 4 of this manual. 


ne ee ee ee 
fColumns { { | 
17 | 10 116 172 | 
Tas ed A a ! 
Juser-name |POWER |DBLK= | | 
etre peer eee gp er ea ep ee ro | 
1 ! [| TRACKGP= t [ 
[prey are op ey ere eng re en ee ! 
| | | LTAB= 1 I 
pS PS ee arg ce eo ee ee a ee ee 
' ] { PRI= | 
| ! | SUBLIB= ] | 
[Pe RP are era a a a oe ee eee | 
| 1 |} ACCOUNT= 1 | 
a aa laa ! 
| | | STDLINE= | ! 
a am ee 
| | | STDCARD= | | 
SSSR Steg eee ee eat he rea eeen ere | 
! I | JLOG= I ! 
Ree ae Rene he ae eS er ee ee een en ! 
| I JJSEP= | | 
aaa a ca aa ni | 
| | |RBS= | i 
aaa ca rd aa | 
! | | RDREXIT= | | 
ae a a oat | 
| j | PAUSE= 1 | 
[Peae RSS Cee eee re rae eee a eee 
t | | SPOOL= t | 
[Ser S See e rE ens eae n ae eae eran sens eee erage ee eee | 
| | |SNA= I l 
Sa e g  eaee Sgs e e  ee  ee ome ena e | 
| l | FEED= I ! 
Pe ee ne ne ee eee pg a Gla en Ty ae a ee eee l 
| | |MOULT12= | | 
ea at a ea | 
| | | COPYSEP= | i 


Figure 2-7 (Part 1 of 2). Work Sheet for Coding POWER/VS Generation 
Macros 
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Ca ee ae a Se a ee te GES GE ee Oe ee ee se aan pg ee eT eee = Tee 


}Columns | | 
}1 } 10 {16 


| TIMEOUT= 


| ee we ee we we oe we we we wm re we ee ee ee we a ee oe owe we we we 
{ |PSWRD= 


Figure 2-7 (Part 2 of 2). Work Sheet fo 
Macros 
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Terminals Supported by POWER/VS 


For RJE,BSC operation, the POWER/VS RJE program can support up to 25 
remote terminals of the types IBM 2770, 2780, 3741, 3780 or 3771, 3773, 
3774, and 3775 (as a 2770) or 3776 (as a 3780); however, only four 
terminals can be attached to a System/370 Model 115 and six terminals to 
a Model 125. 


For RJE,SNA operation, POWER/VS supports up to 200 work stations (single 
or multiple logical units) of the types IBM 3770 and 3790. 


IBM 2770 DATA COMMUNICATION SYSTEM 


This system may be used as an RJE terminal. It can be connected to the 
central system by means of common carrier leased or switched facilities. 
The devices that are attachable to the IBM 2770 are described in System 
Components: IBM 2770 Data Comaunication System, GA27~3013. 


oe SS ee ES SR ee eS ES A A ee eS ee Se ee ee we 


—=— a oe Lo eee. 


e 545 Output Punch, Model 3 or & (output switch 2) 
* 2203, Model Al or AZ, or 2213 Printer, Model 1 or 2 (output switch 1) 


e 2502 Card Reader, Model Al or A2 (input switch 2). 


Notes: 
1. A card reader and a printer are required, a card punch is optional. 


- The standard keyboard provided with the 2770 may be used as a 2502 
reader for text that is compatible with card input. Such input is 
limited to entry of commands and short ‘job streams (the complete 
stream must fit entirely into the 2770 buffer). Lowercase 
characters are not translated to uppercase; therefore, uppercase 
characters must be entered specifically if so required. 


ined 


a ne ch ee SS A a a EE le oe Se 


EBCDIC or ASCII transmission code 


Extended retry transmission 


WACK response (wait before transmit positive acknowledgment) 


e Line termination. 
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Supported Features 


Buffer expansion (256 characters} 

e Additional buffer expansion (512 bytes) 

e« Space compression/expansion 

* Horizontal format control 

e Automatic answering 

e 144-character print line 

e EBCDIC transparency {required for object decks only). 

Only punched output to a remote terminal may be in transparent mode. If 
punched output is not a requirement, or if the user transmits in non- 
transparent mode only, the EBCDIC transparency feature on the 2770 and 


transparency on the 27013 Data Adapter Unit or Integrated Communications 
Adavter may be omitted. 


IBM 2780 DATA TRANSMISSION TERMINAL (MODEL 1 OR 2) 


This terminal can be connected to the central system by common carrier 
leased or switched facilities or privately owned communication 
facilities. The devices that are attachable to the IBM 2780 are 
described in Component_Description:_IBM_2780_ Data Transmission Terminal, 
GA27-3005. 


Required Features 


EBCDIC or ASCII transmission code 


e Extended retry transmission 
e Line termination 


* WACK response (wait before transmit positive acknowledgment). 


Supported Features 


¢* Multiple record transmission (up to 7 records) 
* Horizontal format control 

* Automatic answering 

e Automatic turnaround (Model 2) 

® 120-character print line 

e t44-character print line 

e Selective character set 


e EBCDIC transparency (required for object decks only). 
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Note: Only punched output to a remote terminal may be in transparent 
mode. If punched output is not a reguirement, or if the user transmits 
his punched output in non-transparent mode only, the EBCDIC transparency 
feature on the 2780 and transparency on the 2701 Data Adapter Unit, 2703 
Transmission Control Unit, or Integrated Communications Adapter may be 
omitted. 


IBM 3741 DATA STATION (MODEL 2 OR 4) 


This data station is supported as an RJE terminal compatible with the 
IBM 2780 without the multiple record transmission feature. It can be 
connected to the central system by means of common carrier leased or 
switched facilities. Devices attachable to the 3741 are described in 
IBM 3741 Data Station Reference Manual, GA21-9183. 


There are no required features on the 3741. 


IBM 3771 COMMUNICATION TERMINAL 


The IBM 3771 Communication Terminal is a multipurpose keyboard/printer 
terminal to which the following I/O devices may be attached: 


e 3501 Card Reader. 


e 3521 Card Punch, with or without Read Peature, attached via an IBM 
3782 Card Attachment Unit Model 1. 


For details concerning the components of the 3771, refer to the 


publication IBM 3770 Data Communication System, System Components, 
GA27—3097. 


POWER/VS supports the 3771 in RJE,BSC mode (as a 2770) and in RJE,SNA 
mode. 


IBM 3773 COMMONICATION TERMINAL 


The IBM 3773 Communication Terminal is a multipurpose keyborad/printer 
terminal with a Magnetic Diskette Storage device with a capacity of 

242 688 bytes of storage. For details concerning the components of the 
3773, refer to the publication IBM 3770 Data Communication system, 
System Components, GA27~3097. 


POWER/VS supports the 3773 in RJE,BSC mode {as a 2770) and in RJE,SWA 
mode. 
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IBM 3774 COMMUNICATION TERMINAL 


The IBM 3774 Communication Terminal is a multipurpose keyboard/printer 
terminal to which the following I/0 devices may be attached: 


e One or two IBM Magnetic Diskette Storage devices (248 688 bytes of 
storage per device). 


e One card reader: either a 2502 Card Reader, attached via a 3782 Card 
Attachment Unit, or a 3501 Card Reader. 


e One 3521 Card Punch with or without Read Feature, attached via a 3782 
Card Attachment Unit. 


*® One 3784 Line Printer. 
Por details concerning the components of the 3774, refer to the 


publication IBM 3770 Data Communication System, System Components, 
GA27—3097. 


POWER/VS supports the 3774 in RJE,BSC mode (as a 2770) and in RJE,SNA 
mode. 


IBM 3775 COMMUNICATION TERMINAL 


The IBM 3775 Communication Terminal is a multipurpose keyboard/printer 
terminal to which the following I/0 devices may be attached: 


e One or two IBM Magnetic Diskette Storage devices (242 688 bytes of 
storage per device). 


* One card reader: either a 2502 Card Reader, attached via a 3782 Card 
Attachment Unit, or a 3501 Card Reader. 


® One 3521 Card Punch with or without Read Feature, attached via a 3782 
Card Attachment Unit. 


For details concerning the components of the 3775, refer to the 
publication IBM 3770 Data Communication System, System Components, 
GA27-—3097. 


POWER/VS supports the 3775 in RJE,BSC mode (as a 2770) and in RJE,SNA 
mode. 


IBM 3776 COMMUNICATION TERMINAL 


The IBM 3776 Communications Terminal is a multipurpose, medium-~speed 
remote job entry terminal. To the basic unit, which is a 
keyboard/printer console, the following I/0 devices may be attached: 


e One or two IBM Magnetic Diskette Storage devices (242 688 bytes of 
storage per device). 
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e One card reader: either a 2502 Card Reader, attached via a 3782 Card 
Attachment Unit, or a 3501 Card Reader. 


e One 3521 Card Punch, with or without Read Feature, attached via a 
3782 Card Attachment Unit. 


Por details concerning the components of the 3776, refer to the 


GA27—3097. 


POWER/VS supports the 3776 in RJE,BSC mode (as a 3780) and in RJE,SNA 
node. 


IBM 3780 DATA COMMUNICATION TERMINAL 


This terminal may also be used as an RJE terminal. It can be connected 
to the central system by means of common carrier leased or switched 
facilities. The devices that are attachable to the IBM 3780 are 
described in Component Information for the IBM 3730 Data Communications 


The 3780 terminal consists of: 

e A card reader 

e <A printer 

* a terminal console 

* A 3781 card punch (optional; must be hardware-attached as device 


2 or 3). 


Required Features 


ae 


e EBCDIC or ASCII transmission code 
e Extended retry transmission 


e WACK response (wait before transmit positive acknowledgment). 


Supported Features 


e Additional print positions 
e Component selection for printer/punch device 


e EBCDIC transparency (required for object decks only). 


= 


otes: 


1. Only punched output to a remote terminal may be in transparent mode. 
If punched output is not a reguirement, or if the user transmits in 
nontransparent mode only, the EBCDIC transparency feature on the 
3780 and transparency on the 2701 or 2703 or on the Integrated 
Communications Adapter may be omitted. 
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2. Online mode settings for RJE terminals attached to a CPU Model 115 
or 125: The bit settings of the ICA line mode specification for an 
RJE terminal that is sharers to a Model 115 or 125 CPU are 


GA33-1510, and in IBM Seaton 7370 “Model 1 125 Functional | 
Characteristics, GA33-1506, respectively. 


IBM 3790 COMMUNICATION SYSTEM 


The IBM 3790 Communication System is a programmable, operator-oriented 
terminal system. POWER/VS supports the 3790 Communication System 
Version 6 as an SNA work station with the 3790 RJE Work Station Package 
(WSP) operating on the 3791 Controller. The 3790 may be attached to the 
host system either by the local channel attachment or by an SDLC 
telecommunications line controlled by a 3704 or 3705 Communications 
Controller. Up to three logical printers, one logical reader and one 
logical console are supported. For details, refer to the DOS/VS 
POWER/VS Work Station User's Guide, GC33-6049. 


POWER/VS Support for Other Devices 


IBM 2560 AND 5425 


POWER/VS supports the IBM 2560 and the IBM 5425 as input or output 
devices. POWER/VS will handle 96-column cards on input and output for 
the 5425. If SYSPCH is assigned to the 2560 or the 5825, POWER/VS 
supports: 

® Program-controlled stacker selection 

e Punch and interpret 

e card print 

e Punch/print. 

The 2560 and 5425 are subject to the following restrictions: 

e POWER/VS cannot update or interpret a card input file. 

e POWER/VS ignores stacker selection for input cards. 

e Read column binary is not supported. 

e In a given partition, POWER/VS will only spool both punch and read 
functions if a unique physical device address is specified for each 
function (user dummy for at least one function), for instance, X*00C* 
for the read function and X*01C* for the punch function. 

© POWER/VS uses hopper 1 for input. 

e POWER/VS uses the hopper specified by the user for output, provided 


separator cards are not specified. If separator cards are specified, 
hopper 2 is used for output. 
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IBM 3525 


POWER/VS supports the basic read and punch functions of the IBM 3525 
card reader. Punch/interpret and punch/print are also supported, as 
well as the card print feature. If SYSPCH is assigned to the 3525, 
POWER/VS supports the following functions: 

¢ Program-controlled stacker selection 

®¢ Print 

e Punch/print (multiline) 

* Automatic line positioning 

e User-controlled line positioning 

e Print overflow. 

The assignment of a logical unit to a 3525 card reader or card punch is 


subject to the same rules that apply to the assignment of a logical unit 
to a 2560 or a 5425. 


IBM 3800 


POWER/VS supports the IBM 3800 Printer as an output device. Before 
installing a 3800, you should be familiar with the contents of the 
DOS/VS_IBM_ 3800 Printing Subsystem Programmer's Guide, GC26-3900. You 
can find information in the section "POWER/VS Considerations" in the 
chapter "Planning for the 3800". 
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Chapter 3. Using POWER/VS 


POWER/VS is a reader/writer spooling processor that provides automatic 
staging of unit-record input and output, class scheduling, and priority 
scheduling for all DOS/VS programs executed under its control. The 
Remote Job Entry (RJE) facility of POWER/VS permits jobs to be submitted 
from remote terminals to the central system and job output to be routed 
from the central system to the remote terminal. 


This chapter describes how to use POWER/VS. At the central system, you 
have two sets of commands, or statements, to control the operation of 
POWER/VS and to submit jobs to the system. These are: 


e The POWER/VS central operator (POCL) commands 
e The POWER/VS job entry control language (JECL) statements. 


The formats and functions of these two sets of commands are explained in 
detail in this chapter. 


In addition, this chapter also covers four other topics. These are: 


e The cross-partition communication macros. These macros enable you to 
request certain POWER/VS functions from within an application program 
not running under POWER/VS control. 


® Specific macros to provide job accounting under POWER/VS and to 
perforr output segmentation, for example, for long-running jobs. 


e The control statements available to start POWER/VS using the 
AUTOSTART feature. 


* General rules for the POWER/VS user. 


At a remote terminal or work station, you use another set of commands. 
These are called the POWER/VS Remote Job Entry (RJE) terminal commands. 
A detailed description of their formats and functions is contained in 
the POWER/VS Work Station User's Guide, GC33-6049. A summary of the 


POWER/VS statements and commands is provided with the POWER/VS reference 
card, DOS/VS_ POWER/VS Reference Summary, GX33-9004. 


POWER/VS Central Operator Commands 


The POWER/VS central operator commands allow you to control POWER/VS and 
POWER/VS RJE operation from the central operator's console. They are 
entered in the same way as attention routine commands. At the display 
operator console of a System/370 Model 115 or 125, these commands can be 
entered directly without pressing the request key. 


For almost all POWER/VS command codes, a 1i-character short form is 
available. All the options of a command are valid for both the short 
form and the extended command code. 

The POWER/VS central operator commands may be divided into the following 
three groups: 
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°* Queue Management Commands. These commands control the various 
POWER/VS input and output queves. 


°* Task Management Commands. These commands are used to control the 
reader/writer tasks and the execution processors. 


e Control Commands. These compands allow special actions concerning 
lines, print forms, accounting, and broadcasting activities. 


Figure 3-1 gives an overview of the three groups of POWER/VS central 
operator commands. 


fo pe eR EO in bee gine) ian a ee a ep ee Pe ee 


|! Type_of | Command [Short |Function 

|Command | Code [Form I 

t | {Operation) | I 

| xe ee ee ee re ee ae De 0 &® @& ow ne ne OO OO OO OS OO WOO SO Oe SBOE OSS eS OS ee & oe 
| | PDISPLAY | D |Display the status of POWER/VS 

| | | |job(s). 

| | | 

|Queue | PALTER } A |Alter the processing attributes of 
| Management | | {a POWER/VS job. 

{Commands | t 

| | PDELETE { L |Delete queue entries or messages. 

| | | | 

| | PRELEASE { Rk {Release POWER/VS jobs for further 

! | | |processing. 

| ee meee cee eee ca ce se cae cee ce we ee eee cee ree ee ne ne ce ce ee ee i ee ce eae ca ee ee ee ee ee oe ee 
| | PSTART | Ss {Start a task or place a partition 

| | | Junder the control of POWER/VS. 

| I t I 

! {PSTOP | P {Stop a task or release a partition 
| t | {from POWER/VS control. 

| | ! | 

{Task | PGO | G }Reactivate a task or a partition. 

| Management | | | 

|Commands | PEND | |Terminate POWER/VS. 

! | | l 

| | PCANCEL {| c }Cancel a POWER/VS status report. 

| | I | 

| | PFLUSH | F {Terminate processing of the current 
| | | JPOWER/VS job. 

| I | I 

| |PRESTART { T |}Restart a writer task. 

| rsp ase iin, em iS eae ‘os, ms xs Sn es cms mums Si un’ ems: min em ‘ces Sess ns mtu ai mo ui ap eg’ em ip“ sma ue i’ em issu caus ms tis 
| {PBRDCST | B |Transmit a message. 

| ! l ! 

[Control | PACCOUNT | a |Save accumulated account file 

|} Commands | j |records. 

| f ! | 

| }PINQULRE } I {Display the status of RJE lines. 

| I ! | 

| | PSETUP ! U |Print page layout. 


NS ee ee Ee ee ee 
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Figure 3-1. POWER/VS Central Operator Commands 


The general format of the POWER/VS centra} operator commands is as 
follows: 


Each central operator command has two fields, the operation field and 
the operand field. The operation field can be specified in either the 
extended or the abbreviated format. The operand field contains one or 
more parameters Separated by commas, or contains no parameters at all. 
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If operands are specified, they must be separated from the operation 
field by at least one blank. An optional parameter of a command is 
enclosed in brackets. Stacked options represent alternatives, one and 
only one of which may be chosen. Braces enclose alternatives, one of 
which must be chosen. The operator commands can be entered in either 
uppercase or lowercase characters. 


Commas have to be set as indicated, trailing commas must not be coded. 


COMMAND DESCRIPTIONS 


oe ee Sree ee a Se ee Ge ee ee ce 


The PACCOUNT (or J) command empties the POWER/VS account file and saves 
the processed account file records. POWER/VS informs you with message 
1031I when the file is nearly full. Message 1079I will indicate to you 
when the account file has been saved. If any POWER/VS task requires an 
account record and no space is available, you will receive message 
10321. 


This command can be used at any time. 


a lt 
|}Operation |Operands } 


| 
{eacroune 
3 


| 

| 

| 

| 

} DEL 

A 

tapeaddr specifies the address of the tape drive on which the file 


is to be written. The format is the following: 


cuu 
X*cuu* 


where cuu is the channel and unit number. 


density specifies the density of the tape on which the file has 
to be written. The format is the following: 


ss 
X*ss' 


tfilename specifies the file name of the labeled tape file to be 
created. If no file name is specified, the system treats 
the file as a standard unlabeled DOS/VS tape file. 


Your programper pmust ensure that // ASSGN and // TLBL 
information (for the labeled tape) is provided in the 
POWER/VS partition before initialization of POWER/VS. 
The // TLBL card must have the filename "tfilename". 
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DISK,afilename specifies that the POWER/VS account file is to be written 
to disk. Your programmer must ensure that // ASSGN, 
// DLBL, and /f EXTENT information (for a disk sequential 
output file) is provided in the POWER/VS partition before 
initialization of POWER/VS. 


The device type on which the saved account file is to 
reside must be the same as that for the IJAFILE. 


The // DLBL card must have the filename “"dfilenane". 


DEL specifies that the account file records are to be 
deleted. 

Examples: 

PACCOUNT 180 Write the account file to an unlabeled tape 


mounted on drive 180. 


PACCOUNT 180,ACCTFLE Write the account file onto tape as a standard 
label file. 


PACCOUNT DEL Delete all account file records. 

PACCOUNT Spool account file records to punch queue. 

If the command is issued without an operand, the account file is spooled 
to disk and stored in the punch queue with jobname=PACCOUNT, priority=1, 
class=P, and disposition=HOLD assigned. To retrieve the account file 
records, start a punch writer task for output class P. 


Each card contains the following information: 


Column Contents 
1 Account record identifier (byte 43 of the account record). 
2-72 Data (bytes 0-70 of the account record) punched in the same 


positions as it appears in the account record, including the 
record identifier. 


73-78 Record number of the account file. 


79-80 Sequence number of continuation cards. One account record 
may require two or three punched cards. 


PALTER Command 


ee ee ee ae ee ee ere 


The PALTER (or A) command alters the attributes of a POWER/VS job after 
it has been logged by POWER/VS. Any number of attributes may be 
modified with one command. 


Changes of the class or priority parameters place the job at the end of 
the specified class or priority group. 


If the command specifies a job that is being executed, POWER/VS issues 
message 1R88I, indicating that the ‘job attributes cannot be altered. If 
the command requests a change of job attributes for a job whose output 
is being processed (the job is already in the list or punch queue), only 
the number-of-copies attribute can be changed, except if the job is 
being transmitted to a 3790 workstation (with PDIR=FMH2). All other 
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parameters are ignored and message 1R88I is issued to indicate that the 
job attributes cannot be altered. If the output is segmented, however, 
and the first segment has already been deleted, not even the number-of- 
copies parameter can be changed. 


Note that the job*s class, disposition, and priority attributes may be 
@ifferent in the input and output queues, because input class, 
disposition, and priority are defined in the * $$ JOB statement, whereas 
output class, disposition, and priority are defined in the * $$ LST 

(* $$ PRT) and * $$ PUN statements. 


If the output job is destined for a 3800 printer, you are able to change 
only the transmission count. The transmission count is displayed in the 
first line of the status report. The total number of copies still to be 
produced (including the transmission in progress) is displayed in the 
second display line of the status report. 


If there is copy grouping (for more information refer to the COPYG 
parameter in the * $$ LST statement) and the output is assigned to a 
3800, and you reduce the number of transmissions and increase it with a 
later PALTER command, the previously truncated group values are 
restored. If the new number of transmissions is greater than the 
original copy grouping, then values of 1 are added. 


SS SS ee ee 
|}Operation |Operands 


ete he ms ee ee ee ee ee ee es ee a ee es ee a ee oe ee ee ee ee ee ee i ee a i 


| ee queue, (jobnane[ ,jobnumber } 
j\a ALL 

*abc 

class1 


{ -PRI=priority } 

{ ,DISP=disposition } 

( ,CLASS=classZ J 

{ ,COPY=number-of-copies ] 
[ ,REMOTE=remid } 


* 


{ ,CMPACT=4 name>] 
NO 


queue specifies the queue for which the command is to be 
executed in the form: 


LST for the list gueue 
PUN for the punch queue 
RDR for the reader queue. 

jobname specifies the job name by which the POWER/VS job is known 
to POWER/VS. The job name can be 2 to 8 alphameric 
characters (including "/", ".", and "-"}) long. 

jobnumber specifies the 1- to 5-digit job number assigned to the 


POWER/VS job by POWER/VS. The PDISPLAY command may be 
used to determine’ the correct job number. 


ALL requests that specific attributes for all POWER/VS jobs 
in the specified queue are to be altered. 
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*abc 


classi 


PRI= 


DISP= 


COPY= 


REMOT&= 


CMPACT= 


Examples: 


requests that attributes are to be altered for POWER/VS 
jobs whose names begin with the specified characters. 
For abc, any combination of up to seven alphameric char- 
acters (including "/", ".", and "-") may be specified. 


reguests that attributes for POWER/VS jobs with the 
Specified class are to be altered. Valid specifications 
are A - Z@ and 0 - 6. 


specifies the new priority of the indicated POWER/VS 
job(s). Priority is specified as a single digit from 0 
to 9. Nine is the highest priority. 


specifies the new disposition of the indicated POWER/VS 
job(s). You can specify: 


H for hold 

K for keep 

L for leave 

D for dispatchable. 


specifies the new class (class 2) of the indicated 
POWER/VS job(s). You can specify any alphabetic 
character from A to Z. Specification of digits 0 to 6 is 
permitted for partition input classes. 


specifies the number of copies to be produced after the 
command is issued, including the one in progress. The 
number~of~-copies specification, which may range from 0 to 
99, applies only to output, and is ignored if specified 
for an input entry. 


may be specified as any number from 0 to 200. '*0° 
indicates the central location. The REMOTE= 
specification applies only to output, and is ignored if 
specified for an input entry. 


specifies whether data compaction is to be performed for 
the transmission of job output to an SNA work station. 


* indicates that the default compaction table 
(defined in the PRMT macro) is to be used. 


name identifies the 4-character name of the compaction 
table to be used. 


NO indicates that no compaction is to be performed. 


PALTER LST,PAYROLL,DISP=H,CLASS=B Change the disposition of the output 


of job PAYROLL to H and change the 
class to B. 


A PUN,*PAYRL,DISP=D Alter the disposition to D of all 


POWER/VS jobs in the punch queue 
whose names begin with PAYRL. 


PALTER LST,P,CLASS=Q Change all class P jobs to class Q. 
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PBRDCST Comman 


a i A ee RE 


The PBRDCST {or B) command enables you to send (broadcast) messages to 
remote users. Up to 16 messages are queued and made available to one or 
all remote users on request. 


Messages to all remote users (ALLUSERS) are queued and given a sequence 
number. This number can be determined using the PDISPLAY command. 


Broadcast messages routed to one specific operator are displayed as soon 
as the terminal is ready to receive the message. 


Ge ge a ge, pM gee a Ren ne es ge Ce a ete Ge a eg ee er 
fOperation |Operands | 


| : 

| JPERDCST |fremid ,*terxt?® | 
18 i \ | 
! | LALLUSERS | 


nectar stores 


remid specifies the remote~id of the user for whom the broadcast 
message is intended. Remote users are identified by numbers 
from 1 to 200. Zero is reserved for the central location. 


ALLUSERS specifies that the broadcast message is intended for all 
remote users. 


*text! specifies the text of the broadcast message, entered between 
single quotation marks. Single quotation marks within the 
message must be entered as two quotation marks. The maximun 
length of the message text is as follows: 


e Por ALLUSERS-type messages: 46 characters. 


° For messages from the terminal to the host system: 60 
characters. 


° For messages from the host system to the terminal: 49 
characters. 


If the length of a message text exceeds these maximum values, 


issue two or more PBRDCST commands, because all characters 
beyond the maximum text length will be truncated. 


Examples: 
PBRDCST 150,*RJE WILL SHUT DOWN IN 30 MINUTES® 
Broadcast this message to the user with the 


remote~ID 150. 


PBRDCST ALLUSERS,*RJE STARTS AT 800 HRS A.M.* 
Broadcast this message to all users in the system. 
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PCANCEL Command 


The PCANCEL (or C) command terminates printing of output initiated by 
the PDISPLAY command, 


fo ae aon gw got ek = ats SPA ea. Seg Sa ea ep eee ee ee eee oe ee Ae 
{Operation {Operands ] 


| 

coer IC STATUS ] | 

pte I. 1 

Ele ea a SEN Nn SS ee eR BOON ae cet ae MF re RANEY ERD ee a eee 

STATUS specifies that the printing initiated by a PDISPLAY command 
is to be terminated. 

Example: 

PCANCEL Terminate printing initiated by. a PDISPLAY command. 


PDELETE_Command 


The PDELETE (or L) command removes one or more POWER/VS jobs from the 
specified queue. Jobs being executed in a partition or being processed 
by a writer task are not affected by this command. 


|Operation {Operands 

foe queve, jobname[ ,jobnumber } 
L 

queue, ALL 


queue,class 


queue, *abc 


Oe ee ee 


MSG[ ,nJ 


oe ee ee ee Se em oe oe 
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queue specifies the queue for which the command is to be 
executed in the form: 


LST for list queue 
PUN for punch queue 
RDR for reader queue. 


jobname specifies the 2- to 8-character job name by which the 
entry is known to POWER/VS. 


jobnumber specifies the t- to S5-digit job number assigned to the 
queue entry by POWER/VS. The PDISPLAY command can be 
used to determine the correct job number. 


ALL specifies that all POWER/VS jobs in the specified queue 
are to be deleted. 


class specifies that all POWER/VS jobs of a certain class are 


to be deleted from the specified queue. Valid 
specifications are A - Z and 0 - 6. 
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*abc specifies that all POWER/VS jobs whose names begin with 
the specified characters are to be deleted from the 
specified queue. You can specify up to 7 alphameric 
characters (including "/", ".%, and "-") following the 
asterisk. 


MSG,n specifies that the ALLUSERS-type message with number n is 
to be deleted. The message number can be determined 
using the PDISPLAY MSG command. If n is omitted, all . 
ALLUSERS-type messages originated by the central operator 
are deleted. 


Examples: 

PDELETE RDR,ALL Delete the entire reader queue. 

PDEL&TE LST,B Delete all class B entries in the list queue. 
PDELETE MSG Delete all ALLUSERS-type messages. 


PDELETE LST,*ASSM Delete all entries in the list queue starting with 
the letters ASSM. 


PDISPLAY Command 


ee Se ee ee ee Oe ee ee ee 


The PDISPLAY (or D)} command can be used to display POWER/VS jobs, 
ALLUSERS-type messages in the POWER/VS queues, or the status of POWER/VS 
resources. An example of a POWER/VS status report is given in 
"Initiating POWER/VS Without AUTOSTART" in Chapter 4. 


The status reports are produced at the logical device SYSLOG or at a 
printer (see the operand “listaddr"). Each queve entry is represented 
by one line containing the following items: 


ae ne ee eee eee ere 
| Items {Characters | 


Jjobname - 

| jobnumber 

[priority 

jdisposition 

}class 

| FROM remote-ID 

{TO remote-ID 
|Number-of-records/pages 
| Number-of ~copies 
}Porms~nuamber 


SNA W Wo oo YI © 


The last four items are displayed for output only. For punch output, 
the number of records is displayed, whereas for list output the number 
of pages is displayed. 


Bach line of the status report starts with the message number 1R46I. If 
the status report is made up of entries from different queues, the name 
of the queue is printed before the first entry is displayed. 


The disposition of a queue entry may appear as H for hold, K for keep 


after processing, L for leave, D for delete after processing or * if an 
execution processor or a writer task is currently processing the entry. 


Chapter 3. Using POWER/VS 59 


The class can appear as an alphameric character from A to Z, or from 
0 to 6. 


Remote~ID is displayed as a number from 0 to 200. The remote-ID of the 
central location is 0. 


The number-of-copies column for an impact printer (such as the IBM 1403) 
displays the number of copies still left {including the copy for the job 
being printed), or the total number of copies to be produced when the 
output file has not yet started to print. For an IBM 3800 Printer 
assigned at job execution time, the column displays the transmission 
count. In order to distinguish between the transmission count value and 
the number of copies, the transmission count is preceded by an asterisk 


(*) - 


If the output file is destined for an IBM 3800 Printer, a second display 
line is issued in the status report indicating: 


e The forms overlay to be flashed 
® The "BURST" request 


e The total or still-to-do number of copies. 


The forms overlay and burst indications are displayed only when they are 
requested for the output job. For more information on the BURST and 
FLASH parameters refer to the * $5 LST statement later in this chapter. 


If CMPACT=name or CMPACT=NO is found in a queue entry, an additional 
line is issued in the status report indicating: 


e The job name (8 characters) 
e The job number (5 characters) 


e The compaction option (NO or *name*, up to 4 characters). 


If a writer task is processing a queue entry when the PDISPLAY conmand 
is entered, the number-of-records/pages is the number of records or 
pages left to be produced for the current copy. The operator can use 
this information to determine whether to stop a writer task or let it 
continue until the current queue entry is completed. 


When a job is not active because it was flushed (by means of the PFLUSH 
command) or stopped (using the PSTOP ... RESTART command) before the 
PDISPLAY command is issued, the number of copies displayed is the 
original copy count as specified in the * $$ LST(* $$ PRT) OR * $$ PUN 
statement. If the ICR is installed the number of copies displayed is 
the current number of copies left to be produced, including the one that 
was in progress when the job was flushed or stopped. However, the 
number of pages/cards displayed is the original total number. 


When processing of a flushed (or stopped) job is resumed again and a 
PDISPLAY is issued subsequently, the number-of-copies value displayed is 
again the number of copies left to be produced, including the one in 
progress, 
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jOperation 
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jobnanre 


jobnumber 


ALL 


HOLD 
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jOperands 
queue, jobname[ ,jobnumber ] 
gqueue[ ,ALL] 
queue, HOLD 
queue,FREE 
queue,RJE[ ,remid ) 
queue, LOCAL 
queue, *abc 
queue,class 


ALL[ ,listaddr } 
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specifies the gueue for which the PDISPLAY command is to 
be executed in the form: 


LST for list queue 
PUN for punch queue 
RDR for reader queue. 


specifies the 2- to 8-character job name by which the 
POWER/VS job is known to POWER/VS. 


specifies the 1- to 5-digit job number assigned to the 
POWER/VS ‘job by POWER/VS. 


specifies a request for the status of all PORER/VS jobs 
in the specified queve. If the queue operand is not 
specified, status information for all jobs in all queues 
is displayed. 


specifies a request for the status of all POWER/VS jobs 
in the specified queve that are not available for 
processing (that is, in hold or leave state). If the 
queue operand is not specified, status information is 
displayed for all such jobs in all queues. 
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FREE 


RJE 


renid 


LOCAL 


*abc 


class 


listaddr 


MSG 


specifies a request for the status of all POWER/VS jobs 
in the specified queve that are available for processing 
(that is, in the keep or dispatchable state). If the 
queue operand is not specified, status information is 
displayed for all such jobs in all queues. 


specifies a request for the status of all RJE-type 
POWER/VS jobs in the specified queve. If the queue 
operand is not specified, status information is displayed 
for all such jobs in all queues. 


Specified with the RJE operand, remid indicates a request 
for the status of all POWER/VS ‘jobs in the specified 
queue that were submitted by, or routed to a specific 
remote user. Valid specifications are 0 for the central 
operator and 1 to 200 for remote operators. 


specifies a request for the status of all POWER/VS jobs 
in the specified queue that were submitted from, or 
routed to the central location. If the queue operand is 
not specified, status information is displayed for all 
such jobs in all queues. 


specifies a request for the status of all POWER/VS jobs 
whose names begin with the specified characters. For 
abc, you can specify any combination of up to seven 
alphameric characters, including "/", ".", and "-". If 
the queue operand is not specified, status information 
for all such jobs in all queues is displayed. 


specifies a request for the status of all POWER/VS jobs 
with the specified class in the specified queue. Class 
can be specified as a character from A to Z, or from 

0 to 6 (input class only). 


specifies the physical printer on which the status report 
is to be listed. Enter the channel and unit address in 
the format 


cuu or X¥cuu®. 


specifies a request to display all ALLUSERS-type 
messages, and to identify the users who submitted then. 
The number displayed with each message can be used to 
delete then. 


specifies a request for a list of all active reader and 
writer tasks, together with the jobs they are currently 
processing. 


specifies a request to redisplay a list of all system 
messages for which an operator response is still 
required. 


specifies a request for the number of free queue records, 
and POWER/VS account records (if applicable). 


specifies a request for the current time and date. The 
current number of virtual storage pages reserved by PFIX 
macros and the current number of POWER/VS tasks is also 
displayed. 
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Examples: 


PDISPLAY RDR,*ASSM Display the status of all POWER/VS jobs in the 
reader queue whose names begin with ASSM. 


PDISPLAY RDR,ASSEM Display the status of POWER/VS job ASSEM in the 
reader gueue. 

PDISPLAY ALL Display the status of all POWER/VS jobs in all 
queues. 


PEND Command 


The PEND command terminates POWER/VS operation, releases all POWER/VS- 
supported partitions and restores the POWER/VS partition to normal 
DOS/VS operation. All unit-record devices in the POWER/VS partition and 
in the partitions controlled by POWER/VS are unassigned. Unless KILL is 
specified, all active POWER/VS tasks are allowed to continue until they 
have finished processing the current POWER/VS job (that is, for the job 
Which is being executed, or whose output is being printed or punched). 
If KILL is specified, POWER/VS is terminated immediately. 


Fa ee ee ee ne ge ee 
}Operation |Operands | 


} PEND | juraddr ! 
| | 1 
] |{KILL[E ,uraddr } | 
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no operand terminates the POWER/VS system normally without a dump or 
status report. 


KILL specifies immediate termination of the POWER/VS systen 
and causes a dump to be printed if a printer is assigned. 
POWER/VS-supported partitions are canceled, but reader 
and writer tasks are terminated as for the PSTOP command. 


uraddr specifies the unit-record device address of the printer 
on Which the status report (dump, if KILL is specified) 
is to be printed. The format can be either cuu or 
X*cuu’. If uraddr is not specified, no status report 
(dump) will be provided. The printer remains assigned 
after POWER/VS has been terminated. 


Note: SYSLST must be assigned to uraddr in the POWER/VS 


partition. 
Examples: 
PEND KILL,OOE Immediate termination with system dump on printer O00E. 
PEND Normal termination without status réport or dump. 


PEND OOF Normal termination with status FEPOELs No system dump 
will be provided. 
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PFLUSH Command 


The PFLOSH (or F) command terminates processing of a POWER/VS job by a 
POWER/VS task. When a reader task is flushed, further input processing 
for the job is terminated and a reader queue entry for the job is not 
built. 


When a writer task is flushed, further output processing for the job is 
terminated and the job's output queue entry is deleted unless HOLD was 
specified or the number-of-copies value in the * $$ LST (* $$ PRT) or 

* $$ PUN statement is greater than 1. The specified reader/writer task 
continues processing for the next available POWER/VS job. 


When a writer task for a job with two or more output copies is flushed, 
its queue entry is also placed in the HOLD state. This output can be 
Started again (from the beginning of the copy whose output was 
interrupted) by means of a PALTER or a PRELEASE command. 


ree Tete cetera ECO gee er a ee 
|Operation JOperands | 


| 

ay | curaddr[ ,HOLD } | 
LUF | \ | 
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|\partition[{ ,HOLD J 
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uraddr specifies the unit record device associated with the 
reader/writer task. 


HOLD specifies that the corresponding queue entry is not to be 
deleted. Once the entry has been placed in the HOLD 
state, it cannot be deleted when a partition or writer 
task is flushed. This operand is ignored if it is 
specified for a reader task. 


You may require the HOLD option, for example, to delay 
processing of a job that needs more resources than are 
available at the time. Jobs requiring the same resources 
may thus be grouped to optimize the use of systen 
resources. 


partition specifies that the POWER/VS job is to be terminated and 
the corresponding reader queue entry is to be deleted 
unless HOLD or KEEP has been specified. In the case of 
DISP=K, the disposition is changed to L. If the reader 
queue entry of a POWER/VS job is deleted, POWER/VS builds 
a list queue entry containing a message to the 
programmer. This message informs him that the job has 
been flushed by the PFLOSH command. Valid partition 
specifications are BG or Fn, where n is the partition 
number. Note, however, that only partitions under 
POWER/VS control can be flushed by means of this command. 


Note: If the command PSTOP cuu,EOJ was previously issued 
for a writer task, the command PFPLUSH causes this task to 
be stopped immediately, but for safety reasons, the job's 
output queue entry is not deleted. 


The current DOS/VS job will be canceled without DUMP, 
regardless of any dump options specified. 
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xamples: 


PPLUSH OOE Delete list queue entry currently being printed and 
continue with next entry. 


PFLUSH BG Delete reader queue entry currently being processed and 
continue with next entry. 


PFLUSH BG,HOLD Terminate processing of reader queue entry currently 
being processed. Place the entry in the hold state and 
continue with the next entry. 


PGO_Command 


The PGO (or G) command reactivates a POWER/VS routine that is waiting 
for an operator response. You would normally use this command after you 
have responded to an action-type message. You cannot use PGO to restart 
a partition or task that was stopped by a PSTOP command. 


Note: Reader tasks operating on card readers that give a "device end" 
interrupt when the READY key has been pressed are automatically 
reactivated when the device end occurs. You do not need the PGO command 
for such tasks. 


Ce a Fe a ad aE Ee ee ee a ee ee 
[Operation JOperands | 
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| Lpartition,cuu 


uraddr specifies the unit record device associated with the 
Writer task (Note: Reader tasks are reactivated 
automatically. They do not need a PGO command). It has 
the format: 


cuu or X*cuu? 

partition,cuu specifies the partition and device whose output is being 
spooled to tape. Valid partition specifications are BG 
or Fn, where n is the partition number. Note, however, 


that only partitions under POWER/VS control can be 
reactivated by means of this command. 


Examples: 


PGO OOE Reactivate a list writer task, for example after the 
required form has been set up. 


PGO BG Reactivate BG execution, for example after a new tape has 
been mounted. 


PGO BG,00E Reactivate BG execution after mounting a tape for the 
output of printer OOE. 
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PINOUIRE Command 


The 
log 


Not 


PINQUIRE {or I) command provides you with status information for a 
specific BSC line or logical unit or for all BSC lines an@ active 


ical units. 


e: When POWER/VS executes on a virtual machine under VM/370 and, for 
whatever reason, this machine entered CP mode, you must not specify the 

short form (I) of the PINOQUIRE command, because this would result in the 
attempt of the Control Program (CP) to perform an IPL. 


= 
feet akae {Operands 
eerouare } (luname ! 
Pur 1 | 
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1 | I 
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lun 


lin 


ALL 


ame specifies the name of the logical unit for which the 
status information is desired. 

eaddr specifies the address of the BSC line for which status 
information is requested, specified in the format cuu or 
X*cuut. 
specifies that status information for all supported lines 


is to be displayed. 


The status of a line or a logical unit may be one of the following: 


PROCESSING 


WOT LOGGED ON 


LOGGED ON 


LOGGING ON 


INACTIVE 


NOT INITIATED 


NOT SUPPORTED 


The remote user has entered a valid SIGNON or 
LOGON command. For BSC users, the remote-ID is 
displayed together with the line status. For SNA 
users, the session is logged on and a processor 
(for example, Inbound or Outbound) is active on 
the session. 


No SNA user is currently logged on to the 
specified logical unit ("luname" specification). 
This status information is not applicable to BSC 
lines. 


The session is logged on, but no processor is 
active (not applicable to BSC lines). 


The session is in process of being logged on (not 
applicable to BSC lines). 


The line has been started by the central operator 
with a PSTART command, but no user is currently 
Signed on (applicable only to BSC lines). 


The line has not been started by the central 
operator (applicable only to BSC lines). 


Support for the line was not provided during 
POWER/VS generation (applicable only to BSC 
lines). 
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Example: 
PINQUIRE ALL Display the status of all supported lines. 


Line status report produced: 


030 PROCESSING 22 
031 PROCESSING 150 
032 PROCESSING 4 
033 NOT INITIATED 
034 INACTIVE 


RT74 LOGGED ON 041 


PRELEASE Command 


The PRELEASE (or R) command takes one or more POWER/VS jobs out of the 
hold or leave state and makes them available for processing. If ALL or 
"class" was specified in the PRELEASE command, jobs with disposition L 
are not released. After processing, a job originally in the leave state 
has its gueue entry returned to disposition L. Output of a POWER/VS job 
that is directed to a terminal can be released only from the terminal. 


Noy ee ee ere ee 
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queue specifies the queve for which the command is to be 
executed in the form: 


LST for list queue 
PUN for punch queue 
RDR for reader queue. 
jobname specifies the job name, consisting of 2 to 8 alphameric 


characters including "/", ".", and "-", by which the 
entry is known to POWER/VS. 


jobnumber specifies the 1- to 5~-digit job number assigned to the 
entry by POWER/VS. Use the PDISPLAY command to determine 
the job number. 


ALL specifies that all POWER/VS jobs in the queue, except 
those with disposition L, are to be released. 


class specifies that all POWER/VS jobs, except those with 
disposition L, of a certain class in the specified gueue 
are to be released. Valid specifications are A - Z@ and 
0 - 6. 


*abc Specifies that POWER/VS jobs in the specified gueue whose 
names begin with the specified characters are to be 
released. You can specify up to seven alphameric 
characters (including "/", ®.", and "-") in place of abc. 
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Note: The central operator may not release jobs routed to a remote 
terminal or work station. 


Examples: 
PRELEASE LST,PAYROLL Release POWER/VS job PAYROLL in the list queue. 
PRELEASE RDR,ALL Release al] POWER/VS jobs in the reader queue. 


PRELEASE LST,*PAY Release all POWER/VS jobs in the list queue whose 
names begin with PAY. 


PRESTART Command 


The PRESTART (or T) command restarts printed or punched output fora 
POWER/VS job from the beginning or from a specified page or card, within 
the segment. It can only be used while the task is active. 


-——— sO  'OYxO9WOnY9E9ODRw??™ 1 
}Operation jOperands ] 
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uraddr specifies the unit record device associated with a list 
or punch writer task. 


n specifies a signed or unsigned value from 0 to 9999. A 
plus sign indicates page or card forward, a minus sign 
indicates page or card backward from the point where 
processing was interrupted. No sign indicates a 
specified count from the beginning. If you specify too 
great a backward count, or if the operand is omitted, 
printing or punching is resumed from the first page or 
card. If you specify too great a forward count, a 
message is issued and the command is ignored. 


i Specifies the copy group index to be used for the 
restart. Any value between 0 and 8 is valid. When 0 is 
specified, a value of 1 is used. When i is omitted, 
output processing continues with the copy group index 
currently used. This operand is valid only for an IBM 
3800 Printer. 


Example: 


PRESTART OOE,-10 Reprint the previous ten pages and continue. 


Note: After a "PSTOP uraddr,RESTART" command has been issued, PRESTART 
cannot be used. A PSTART must be given before to reactivate the task. 
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PSETUP_ Command 


The PSETUP (or U) command prints one or more pages of list output with 
all printable characters of a page replaced by the character X. When 
the PGO command is issued to resume printing, the pages are printed 
again with their original contents. The command allows you to check and 
adjust forms alignment. Adjustment is made manually while printing of 
the setup pages is in progress. The PSETUP command may be used only 
after message 1OQ40A or 1Q0A5A has been received. 
nD ee fe Te ge ag eee ee 
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uraddr specifies the device address of the printer on which the 
pages are to be printed. 


n specifies the number of pages to be printed as one or two 
' digits. If n is omitted, only one page is printed. 


Note: A page is defined as a skip to channel 1. That 
Means: if a job output does not contain skips to channel 
1, POWER/VS will count the entire output as one page. If 
a PSETUP is issued in this case, the complete job output 
will be printed with X characters. 


Example: 


PSETUP OO0E,2 Print two setup pages 


Page 1 

XXXX XXXXXX XXXXXX 
XX XXXXxXX XXXXX x XxXXXXXxXxX 
XX XXXXXxXxX xXXXX x xXXXXxX 
Page 2 

XXXX XXXXXX XXXXXX 
xX xXXXX XXXXX x XXXXXX 
XX XXXx xXXXXX x XXXXXX 


When the PGO command is issued to resume printing, the pages are printed 
again with their original contents. 


Page 1 

NAME NUMBER SALARY 
L. KEEPFE 69060 $ 1,080.05 
N. REYNOLDS 414240 $ 798.83 
Page 2 

NAME NUMBER SALARY 
D. HALEY 331710 $ 497.171 
A. WATT 76779 $ 699.42 
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PSTART Command 


Se cn Re RE EE 


A PSTART (or S) command starts either a partition or a reader, writer, 
or RJE task. 
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| 
i 
| 
} 
| 
| 


RJE,SNA 


task specifies the task to be started in the form: 
RDR for reader task 
LST for list task 
PUN for punch task. 
uraddr specifies the unit-record device associated with the 


reader or writer task. You may specify X'cuu* or cuu. 


class For a writer task, this operand specifies the output 
class or classes that the task may process. Up to four 
classes may be specified by any four alphabetic 
characters from A to Z. The order in which classes are 
specified will be the order of processing. The default 
Class is A. 


For a reader task, this operand defines the input class 
that is to be assigned to all jobs without a class speci-~ 
fication in their * $$ JOB cards (provided no * $$ CTL 
statement is in effect). "“class" is specified as an 
alphameric character from A to 2, or from 0 to 6. The 
default class is A. 


For a partition, this operand is used to define the input 
class (or classes) of the jobs that may be executed in 
the partition. Up to four classes may be specified using 
from one to four alphameric characters: A to Z or 0 to 6. 
The order in which classes are specified will be the 
order of execution. If class is not specified, only 
partition-dependent jobs (that is, POWER/VS jobs with a 
matching partition-type input class) are selected. 


n specifies the number of buffers that the task will use. 
Valid specifications are 1, 2, or D, where: 


1 buffer 
2 buffers 


1 
2 
D 4 buffers (2 input and 2 output buffers). 


oe 
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partition 


outclass 


MT 


tapeaddr 


craddr 


duaddr 


'file-id' 


vols 


The specification of D is valid only for a list writer 
task and if the ICR is installed. The operand n is 
ignored for a punch writer task. If the operand is 
omitted, the task is started with one buffer. 


Note: Storage for the buffers is used only as long as 
the task is active. When the task becomes inactive, the 
buffers are released and the storage is returned to the 
POWER/VS storage pool. 


specifies the partition to be brought under the control 
of POWER/VS. If the partition is already controlled by 
POWER/VS, the PSTART command acts the Same as a normal 
attention routine START command. A message is issued if 
the partition is still active or not supported, or has a 
higher priority than the POWER/VS partition. Valid 
specifications are BG or Fn, where n is the partition 
number. 


specifies the default class of this partition's output. 
May be any alphabetic character. The default is A. 


specifies that this partition is to support a never 
ending (or long running) multitask job. When no more 
cards are available for the partition, only the task 
which reads cards is placed in the wait state. Other 
tasks continue and provide output. Segmentation of the 
output is controlled via the LFCB macro (forms control 
buffer printer only) or the SEGMENT macro (printer and 
punch output). The initial job stream for this partition 
should have a LST and PUN statement for each spooled 
output device that may be used. A PSTOP command for this 
partition also cancels the multitasking parameter. 


specifies the address of the tape drive on which a svool 
tape is mounted. Only list and punch tasks can be 
started from a tape. “tapeaddr" must be specified as 
X*cuu’. 


specifies the address of the card reader for a reader 
task that is to read input from both a card reader anda 
diskette. You may specify X*cuu' or cuu. 


specifies the address of the 3540 diskette unit whose 
input is to be spooled. You may specify X*tcuu® or cuu. 


specifies that a reader task is to be started with two 
buffers. If this operand is not specified, the task is 
started with one buffer. 


specifies the name of the diskette file to be read; it 
must be identical with the file name in the HDR1 label on 
the diskette. One to eight alphameric characters, 
including blanks, may be entered between the quotes. 


specifies the maximum number of diskettes to be read. 

The reader task terminates either after the specified 
number of diskettes has been read or at the end of a 
diskette whose HDR1 label indicates that this is the last 
diskette of the file. Any decimal number from 1 to 255 
may be specified; the default is 1. 
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RJE 


lineaddr 


password 


RJE,SNA 


Examples: 


specifies that volume sequence checking is desired. The 
sequence number of the first volume pust be 17 and the 
numbers of succeeding volumes must be specified in 
increments of 1. 


specifies that only diskette files that have been 
verified are to be accepted. If *V* is specified and the 
diskette file to be read has not been verified, the file 
will be rejected. If the parameter is omitted, no 
checking for whether diskette files have been verified 
will be carried out. 


specifies that the command was given to start an RJE,BSC 
task e : 


specifies the line address associated with the RJE task. 
You may specify the line address as X*cuu* or as cuu. 


specifies a password consisting of up to eight 
characters. If you specify a password, the remote 
operator can only sign on by specifying the same password 
in his * .. SIGNON command. 


causes POWER/VS to activate the VTAM interface. Upon 
completion, a message is sent to the central operator 
indicating that the SNA work stations may now log on. 


PSTART RDR,OOC,2 Start reader task on X'00C'. Assign class 2 to 


all jobs without class assignments. 


PSTART RJE,O30,NEWYORK Start an RJE task on line 030. NEWYORK is the 


security password. 


PSTART LST,00B,AB Start a list task on X'OOB* to print output 


output from POWER/VS jobs with classes A and B. 


PSTART PUN,OOD,X'285* Start a punch task on X*00D* to punch output that 


PSTART F1,AB 


was spooled onto tape mounted on drive x*285*. 


Bring F1 under control of POWER/VS. Select (for 
execution) input classes A and B only. 


PSTART RDR,O0OC,,2 Start a reader task on X*O0OC* with two buffers. 
Assign class A to all jobs without class 
assignments. 

PSTART F2,Z2,B,MT Bring F2 under control of POWER/VS. Select (for 


execution) input class Z only. The default 
output class for this partition is B. This is a 
multitask partition. 


Note: If you want to process a diskette containing more than one SYSIN 
file, one specific PSTART command is required for each SYSIN file to be 


processed. 
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PSTOP Command 


The PSTOP (or P) command stops a reader, writer, or RJE task, or 
releases a partition from POWER/VS control. 


Unless modified by the EOJ operand, PSTOP terminates tasks in the 
following way: when a reader task is stopped, further input processing 
for the POWER/VS job being read is terminated. No entry for that job is 
placed in the input queue. When a writer task is stopped, further 
output processing is terminated, but the terminated output is not 
deleted from the output queue. When the task is started again, 
processing of this output starts with the first record. 


For reader/writer or RJZ,BSC tasks, POWER/VS acknowledges the PSTOP 
command with a message at both the central location and the terminal. 


a ee ee ee te ee 
{Operation {Operands ! 


er er er rn terrae | 


oe uraddr|,EOJ 
Pp eRESTART 


partition 


lineaddr[ ,20J J 


RJE,SNA[ , £0J J 


RJE,SNA,lunane[ ,EOJ } 
a 8 ee 


uraddr specifies the unit-record device address associated with 
the reader or writer task. You may specify X'cuu’ or 
cuu. . 

EOJ specifies that the task will not stop until it has 


completed processing for the current POWER/VS job. This 
means (1) for a reader task that it will not stop until 
all input for the POWER/VS job being read has been 
spooled and (2) for a writer task that it will not stop 
until all currently processed printed (or punched) output 
for a particular POWER/VS job is complete. £EOJ should 
always be specified for RJE tasks, unless an emergency 
occurs. 


RESTART specifies that when the task is restarted, processing 
will begin at the record following the last one processed 
before the PSTOP command was issued. This applies also 
when the number-of-copies value was specified greater 
than 1. RESTART applies only to output processing. 


Note: If neither RESTART nor EOJ is specified when an 
output task is stopped, processing will begin with the 
first record of the same output when the task is started 
again by a PSTART command. 


The PRESTART compand cannot be used after a PSTOP 
command. 
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partition 


lineaddr 


RJE,SNA 


lunane 


Exanples: 


PSTOP OOE,EOJ 


PSTOP 030 


specifies the partition to be stopped. When a partition 
is stopped by means of a PSTOP command, the partition not 
only is stopped, but is completely released by POWER/VS. 
This form of the PSTOP command is not effective until all 
processing for the POWER/VS job currently being executed 
is completed. Valid specifications are BG or Pn, where n 
is the partition number. Note, however, that only 
partitions under POWER/VS control can be stopped by means 
of this comaand. 


After the partition has been released by POWER/VS, the 
partition may be started as a normal batch partition 
using the START command. To restart it as a POWER/VS- 
controlled partition, use the PSTART command. 


specifies the line address (X*cuu’ or cuu) associated 
with the RJF task. 


causes POWER/VS to deactivate the VTAM interface 
immediately. The optional specification EFOJ allows an 
orderly termination; that is, active inbound or outbound 
processes may continue until the current job entry is 
completed. 


specifies, in combination with the operands RJE,SNA (and 
in addition, optionally, EOJ) that POWER/VS is to 
deactivate only the session identified by the "luname" 
operand. For multiple logical unit work stations, 
individual sessions may be logged off by the central 
operator without logging off the entire work station. 


Stop the list writer task operating on OOF after it 
has completed printing the list output of the current 
POWER/VS job. 


Stop the RJE task operating on line 030 immediately. 
If this task is reading, the input records already 
spooled for the current RJE job are lost. If the 
task is writing, output will start from the first 
record of that output when the task is restarted. 


PSTOP O0OD,RESTART Stop the punch task operating on 00D. When the task 


PSTOP F3 


is started again, processing of the stopped entry 
will continue at the point of interruption. 


Release partition F3 from control of POWER/VS after 
execution of the POWER/VS job currently being 
processed is complete. 


PSTOP RJE,SNA,EOJ Stop all RJE,SNA sessions as soon as processing of 


all jobs in all sessions has been completed. 


PSTOP RJE,SNA,SES1 Terminate the SNA session with the name SES1 


immediately. 
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POWER/VS Job Entry Control Language Statements 


Under POWER/VS, a job is not necessarily the same as a job under DOS/VS. 
To define a job to POWER/VS and have that job logged in the system, the 
POWER/VS job entry control language (JECL) or the DOS/VS job control 
language {JCL) may be used. Examples are shown in Figure 3-2. 


If JCL is used, a job is logged under the name specified in the // JOB 
statement, and this statement, together with the /& statement, delimits 
the job. If JECL is used, the * $$ JOB and * $$ EOJ statements delimit 
a job, and the name specified in the * $$ JOB statement is used to log 
the particular job. A job defined to POWER/VS by using JECEL may 
comprise several DOS/VS jobs or only part of such a job. 


You should be aware that POWER/VS will generate a /& in the job stream 
in two instances: 


e If POWER/VS reads a // JOB statement without an immediately preceding 
7a statement. 


e If several POWER/VS jobs are defined for one DOS/VS job, where an 
* $$ JOB statement is not immediately preceded by an * $$ EOJ 
statement. 


Because JECL statements begin with an asterisk-blank, job control treats 
them as comments when POWER/VS is not in operation. This also means 
that for a writer-only system, dual entries would be created for LST, 
PUN, and PRT statements. Because this is not allowed, // OPTION NOLOG 
should precede the JECL statements. 


POWER/VS assigns a number to each job name that it logs in order to 
distinguish between jobs for which identical names were specified. You 
must use that name and, possibly, the number assigned to it whenever you 
issue an operator command to control the processing of that job entry. 
Once a job has been defined to, and logged in, the system by POWER/VS, 
that job is referred to as a POWER/VS job. The first LST (and the first 
PUN) output from a POWER/VS job will have the same number as the input 
job. However, any subsequent LST or PUN entries will have unique job 
numbers in order to facilitate queve manipulation. All segments of 
count-driven segmentation (RBS=xxx) will have the same number as the 
first segment. For accounting purposes, all output contains the job 
number of the reader queue entry when a record is placed in the account 
file. 
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OOS/VS Comments 
Job Stream 


if JOB ONE 


DOS/VS Job, 


u EXEC JOBSTEPA with no JCL changes. 


18 
// JOB TWO 


// EXEC JOBSTEPB 
* No *$$ JOB/EOJ required 
*$$ PUN CLASS=X for LST or PUN statements. 


d/ EXEC JOBSTEPC 
* 


8 

*$$ JOB THIRD 
// JOB THREE 

i Optional POWER/VS JECL, 


// EXEC JOBSTEPD Required if SYSIPT statements 
* include a // JOB card. 

1& 

*$$ EOS 


*$$ JOB FORTH 
// JOB FOUR 

* 

No *$$ EQJ required, if 
POWER/VS job is followed 


/f EXEC JOBSTEPE 
by *$$ JOB statement. 


// EXEC JOBSTEPF 
* 


/& 

*$$ CTL CLASS=B 
*$$ JOB FIFTH 

// JOB FIVE 


Default CLASS changed to B. 


: 
/} EXEC JOBSTEPG aa cea baa. 


1& 
*$$ JOB SIXTH 
// JOB SIX 


// EXEC JOBSTEPH 
= Multiple DOS/VS jobs in one 


1& POWER/VS job. 
{/ JOB SEVEN (*$$ JOB and *$$ EOJ are 
* both required for this.} 


// EXEC JOBSTEPI 


/& 

“$$ EOJ 

*$$ JOB SEVENTH 
// JOB EIGHT 


// EXEC JOBSTEPJ 


*$$ EOJ 
as Multipie POWE R/VS jobs for 


*$$ JOB EIGHTH one DOS/VS job. 


{1 EXEC JOBSTEPK 


18 

*$$ EOJ 

*$$ CTL CLASS=A 
// JOB NINE 


// EXEC JOBSTEPL 


Default CLASS reset to A. 


POWER/VS will generate the 
missing /&. 


// JOB TEN 
*$$ LST FNO=8X11 
* 


ui EXEC JOBSTEPM Multiple LST outputs per job 


*$$ LST JSEP=2,RBS=100 (2nd report is segmented.) 


/f EXEC JOBSTEPN 
* 


1% 


Figure 3-zZ. Examples of the Use of POWER/VS JECL 
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FUNCTIONS OF JECL STATEMENTS 


JECL provides a convenient means for the programmer to specify how 
POWER/VS is to handle a particular job. He may use JECL statements for 
the following: 


1. Under POWER/VS and POWER/VS RJE to: 


e Assign job execution priorities. 

e Assign input and output dispositions. 

® Hold a job entry in one or all queues. 

®* Direct unit-record print or punch output to tape rather than te 
disk. 

e suppress spooling of unit record print or punch output. 

e Specify the partition in which the job entry is to be executed. 

e Specify the input or output class. 

® Request segmentation of lengthy output. 

e Insert source statement library data into the input strean. 

e Specify 3800 printer character style selection, bursting, forms 


overlay flashing, and copy modification. 
2. Under POWER/VS RJE only to: 


* Direct output to another user or messages to all terminal users. 

e Direct output to be returned to a terminal or to be processed 
locally at the central systen. 

e Specify compaction table names (SNA only). 


Normally you will not be concerned with the completion of JECL 
Statements; you may, however, be called upon to change or correct JECL 
statements that your programmer prepared and inserted in the job stream. 


For the JECL statements * $$ LST, * $$ PRT, and * $$ PUN, POWER/VS 
provides the possibility of error correction at job execution time. if 
one of these statements was incorrectly specified, the central operator 
receives a message indicating the error. He may then do:one of the 
following: 


e Correct the erroneous statement 

e Ignore the error 

e Flush the job. 

To correct the error, the central operator types in a correct JECL 
statement, upon which the system processes this statement and continues 
executing the job. 

To ignore the error, the central operator enters End-of-Block or a 
corresponding command (depending on the type of console) at the systen 
console. The system then selects default values for the JECL statement 
parameters in error and continues processing. 


To flush the job, the central operator enters FLUSH. The system starts 
processing the next job in the associated queue. 


FORMAT OF JECL STATEMENTS 


A JECL statement must be completely contained in columns 1-71; column 72 
of a single statement must be blank. If the statement is continued, 
column 72 must contain a non~blank character. However, LST and PUN 
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statements cataloged in SLI books cannot be continued. Columns 73-80 


may 


be used as a sequence field. This is illustrated in Figure 3-3. 


|Columns ! } ! | 
}1-4 }5-71 }72 } 73-80 1 
eee re ne en eee 
JIdentifi- [Operation |Operand j Comments |Contin-|Seguence Field | 
jcation } Field |Field | Field {uation | | 
| Field | {Field ! 
| 

* 1 

| 

| 


Figu 


—P ap omen =D 


| 

| { 

$h | I 
| | 

| | 


@ @ @ 


re 3-3. Format of JECL Statements 


© 


Bach JECL statement consists of the following fields: 


1. 
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Identification field: Contains the characters * $$ in columns 1 
through 4. Column 2 must be blank. This field can be used for 
POWER/VS purposes only. 


Operation field: Specifies the JECL operation. It may either 
directly follow the second dollar sign or be separated from the 
second dollar sign by one or more blanks. At least one blank must 
separate the operation field from the operand field. 


Qperand field: Contains one or more positional or keyword 
parameters, Separated by commas. A blank terminates the operand 
field; therefore, no parameter may contain embedded blanks. Keyword 
or positional parameters cannot be mixed within one statement. 


When a keyword parameter contains subparameters, the subparameters 
must be separated by commas and enclosed in parentheses. When only 
one subparameter is specified, the parentheses can be omitted. 


Note: Some POWER/VS features are supported only through keyword 
notations. 

Positional parameters must be specified in a fixed order. If a 
positional parameter is omitted, its delimiting comma must be coded. 
If trailing parameters are omitted, trailing commas can also be 
omitted. fe no parameters are specified, the entire operand field 
can be omitted. When a comment field is present and the entire 
operand field is blank, the omitted operand field is indicated by a 
comma, Which is preceded and followed by at least one blank. If the 
operand field exceeds column 71, the field may be continued 
according|to the following rules: 


e The operand field can be broken after a comma that separates two 
parameters, and can be continued on the next card starting from 
columns 6 through 16. Column 72 of the first card must contain a 
nonblank character. This process can be repeated for as many 
cards aS are necessary. Continuation cards are not supported for 
LST or PUN statements within SLI books. 


e Columns 1 to 4 of each continuation statement must contain * $$ 


(asterisk~-blank-dollar-dollar). Column 72 of a one-card 
statement or a last continuation card must be blank. 
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4. Comments field: May contain any information. This field can be 
broken off anywhere and continued on the next card in any column, 
subject to the same rules given for the operand field. 


5. Continuation field: As stated above, this field (column 72) is used 
to indicate that the information in the present card is continued in 
the next card, 


6. Sequence field: May contain up to eight characters of optional 
information used for control statement identification. If present, 
the sequence field is positionally dependent and aust start in 


column 73. 


Note: POWER/VS converts all POWER/VS JECL statements (including 
continuation cards) and DOS/VS JCL statements (starting with // in 
columns 1 and 2) to uppercase characters before they are written onto 
the POWER/VS data files. The sequence field (columns 73 to 80) will not 
be converted. 


The DOS/VS commands /*, /&, permanent ASSGN and comment statements are 
not converted to uppercase. 


USING JECL STATEMENTS 


Figure 3-4 lists all JECL statements, together with a brief explanation 
of their functions, in alphabetic order. This overview is followed by 
detailed discussions of the function and the parameters of each of these 
statements. 


Got eg TE ee pe ge ee gtr pe ee eg ee Se pee ee ee ee ee 
| JECL Statement {Function ! 


* $$ CTL [Assigns a new default input class to POWER/VS jobs. | 
| | 
* $$ DATA |Inserts data from the reader queue into a book 
|being read from a source statement library. 


| 

[ 

1 I 
t | 
| { 
{* $3 EOI jIndicates the end of a POWER/VS job. | 
| I ! 
}* $$ JOB [Indicates the beginning of a POWER/VS job and ! 
t |provides handling information. ! 
I 1 t 
1* $$ Lst JProvides handling information for printed output. | 
|* $$ PRT } | 
| | { 
|}* $$ PUN [Provides handling information for punched output. | 
| | | 
}* $$ RDR |Inserts a diskette file into the input stream from | 
| Ja card reader. | 
I | | 
}* $$ SLI JInserts data from a source statement sublibrary { 
| Jinto the job strean. j 
l l I 
|* $$ /* |Indicates the end of a POWER/VS job step (used with| 
| [the SLI statement only). | 
! ! | 
}* $3 /& |indicates the end of a POWER/VS job (used with the | 
{ | 


|SLI statement only). 
| a a rE ee | 


Pigure 3-4. JECL Statements 
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The CTL, JOB, and EOJ statements should be presented at DOS/VS job 
control time. All other JECL statements can be included anywhere in the 
input stream. More than one LST or PUN statement is allowed per 
POWER/VS job. 


JECL (* $$ JOB and * $$ EOJ) must always be used in a writer-only 
partition (a partition that uses POWER/VS only for its output) and is 
used with the following restrictions: 


e RDR, CTL, SLI, and DATA statements are treated as comments. 


e LST and PUN statements are recognized at job control time, or when 
user-generated and written to SYSLOG. 


e A number of JOB statement parameters are not meaningful and are 
ignored. 


e Output produced outside the bounds of a POWER/VS-defined job will be 
ignored. 


Note: Data-driven output segmentation is not supported in a writer-only 
partition. 


JECL statements contained in a user data stream are considered to be 
data if read by a writer-only partition. This allows source statement 
books containing JECL statements to be cataloged. Specifically, LST, 
PUN, and DATA statements should be included in source statement books. 
But a JOB statement will only appear on SYSLOG, and an EOJ statement 
will act as "no operation". SLI is invalid in a source statement book 
which is to be cataloged. 


Note: For most of the JECL statements, you may specify parameters 
either in the keyword or in the positional form; but do not use both 
forms in the same statement. If you use the positional form, you must 
code a comma whenever you omit an operand, except at the end of a 
statement. For example, in the statement 


* $$ PUN H,,03 
omission of the "forms-number™ operand is indicated by the second comma 


following the character H, while omission of the “norbm1" operand at the 
end of the statement requires ho extra comma. 


An optional parameter of a command is shown enclosed in brackets. 
Braces enclose alternatives, one of which must be chosen. Stacked 
options represent alternatives, one and only one of which may be chosen. 
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*_ $$ _ CTL Statement 


The * $$ CTL statement allows you to assign a new default input class 
specification for POWER/VS jobs that are not controlled by JECL, or for 
which the class parameter was omitted from the * $$ JOB statement. The 
* $$ CTL statement may be placed at any POWER/VS job boundary. It 
overrides all input default class specifications presently in force and 
remains in effect until the next * $$ CTL statement is encountered or 
the reader task is stopped with a PSTOP command. The statement is 
ignored in a writer-only systen,. 


a ee ee ee ae aa ae eT eee ete ye ae eee ag et soos ee 
|}Operation tOperands 


a oe ae oe om oe ee ee om ee a oe a ae Oe Oe Fe a re ee ee ee Oe Oe ee ee ee eee wee ee ee ee 


! 
| i ' 
}* $$ CTL || cLASS=JA | 
| | class | 

a a 


Note: This statement is only available in the keyword format. 


CLASS= specifies the input class to which ail subseguent jobs 
are assigned if they do not contain a class specification 
in their * $$ JOB statement. The CLASS= parameter may be 
used in order to group jobs that require the same I/0 
configuration, partition, or other resources for 
execution. If CLASS= is not specified, class A is 
assumed. The class specification may be specified as any 
alphabetic character from A to Z or as a single number 
from 0 through 6. When specified as a number, the input 
is partition-dependent. 


The CLASS= parameter in the * $$ CTL statement overrides 
the class specified in the PSTART command, which 
overrides default class A. 


* $$ DATA Statement 


The * $$ DATA statement allows you to insert data into a book that is 
retrieved from the source statement library by an * $$ SLI statement. 
Input following the DATA statement must be terminated by a /* or /& 
statement. DATA statements must be preceded by an * $$ SLI statement; 
otherwise, they are treated as comments. * $$ SLI update statements 
($SLI in columns 73-76) and * $$ DATA statements may be used together. 
However, they must appear in the job stream in the same order as the 
corresponding images appear in the source statement library book. The 
statement is ignored in a writer-only partition. 


Qipao caer ee es as ks yn PO eT RS te eee ee aye AO MS ae ee an ee ae ees See Te age he 
JOperation |Operands 


Sm i ee ie me ee ee Oe a Oe ae ee eee wee ee eee ee 


Note: This statement is only available in the positional format. 


hame specifies the name of the corresponding * $5 DATA 
statement in the source statement library book where data 
is to be inserted. The name can be from one to eight 
alphameric characters, the first of which must be 
alphabetic. 
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oe or PO ee ee ee ee ee ee 


The * $$ EOJ statement marks the end of a POWER/VS job and, if used, is 
normally placed at the end of a DOS/VS job or job step. This statement 
is required in a writer-only partition. If this statement is submitted 
at any other time than DOS/VS ‘job control time, it is still acted upon 
by POWER/VS. 


I 


{Operation }Operands 1 


|* $$ EOI | 


| pe eC ee | 


This statement has no operands. 


* $$ JOB Statement 


The * $$ JOB statement may be placed anywhere in a DOS/VS job stream to 
specify POWER/VS job attributes or to begin a POWER/VS job. This state- 
ment is required in a writer-only partition. 


An * $$ JOB statement encountered in the input stream without a 
preceding * $$ EOJ statement is used as a delimiter for the previous 
POWER/VS job. If the * $$ JOB statement is omitted, POWER/VS jobs are 
delimited by the // JOB and /& job control statements. The POWER/VS job 
name is then copied from the DOS/VS job name. 


Note: In a writer-only partition, an * $$ EOJ statement must precede 
any subsequent * $$ JOB statement. 


Positional format: 


Qo OO 


jOperation Operands I 


i 
[* $$ JOB | [acvroname!,|[p ,( priority ),[ class} " 
| || jobname disposition f 


Se a oe 
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Keyword format: 


| Operation 


| 
* $$ JOB 


! 
| 
i 
l 
1 
! 
| 
I 
! 
| 
L 


jOperands 
" joe avzowans\ 
j jobname 


| »DISP= Dd 
| disposition 
| 


I{ »-PRI=priority ] 


| 
{{ ,-CLASS=class ] 


If ,;USER=user information } 
ei am sm ci mpg eit ci ii ne 


Note: The USER operand can only be specified in the keyword format. 


DISP= 


specifies the name by which the job and its queue entries 
are known to POWER/VS. If the job contains several 
DOS/VS jobs, they are all logged in POWER/VS by the job 
hame in the * $$ JOB statement. The default name 
AUTONAME is assigned if "jobname" is not specified. The 
job name may be specified as two to eight alphameric 
characters (0 - 9, A - 2, #, $, 0, /, ~, OF period (.)). 
The use of the job names ALL, HOLD, FREE, RJE, LOCAL, or 
one-character job names should be avoided as they may 
conflict with some POWER/VS operator commands. 


specifies how POWER/VS will route and schedule the 
associated entry in the read queue. It may be one of the 
following: #8 for hold, K for keep, L for leave, or D for 
delete after processing. The default is D. 


D - Delete after processing. The job is automatically 
scheduled by POWER/VS according to its class and 
priority. After job execution, the read queue entry 
is deleted from the read queve and the data file 
space is released. 


H - Hold job. The job remains in the read queue; it is 
not dispatched by POWER/VS until the operator changes 
the disposition to D or K by means of the PALTER 
command or issues the PRELEASE command. 


K ~ Keep after processing. The job will be automatically 
scheduled by POWER/VS according to its class and 
priority. After job execution, the read queue entry 
is not deleted from the read queue, but the 
disposition becomes L. 


L - Leave in queue. The job remains in the read queue; 
it is not dispatched by POWER/VS, until the operator 
changes the disposition to K or D by means of the 
PALTER command or issues the PRELEASE command. 


Note: The specification of a disposition is ignored ina 
writer-only partition. 
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PRI= 


CLASS= 


USER= 


specifies the priority assigned to this job in both input 
and output queues. It is specified as a single digit 
from 0 to 9. Nine is the highest priority. If the 
priority parameter is not specified, POWER/VS assigns the 
default priority defined in the PRI= parameter of the 
POWER macro. Jobs are dispatched on a first~in-first~out 
basis within priority and class. The specification of a 
priority is ignored in a writer-only partition. 


specifies the class that is assiaqned to the job entry in 
the input queue. It may be specified as an alphabetic 
character from A through Z, or as a numeric character 
from 0 through 6. This parameter may be used to group 
jobs that require the same I/O configuration, partition, 
or other resources for execution. The specification of a 
class is ignored in a writer-only partition. 


Classes 0 through 6 have a specific meaning and are 
called the partition-dependent classes. Jobs with class 
0 can only be selected for execution in the background 
partition, jobs with class 1 in partition F1, and so on. 


If the class parameter is omitted, the class 
specification is taken from the CTL statement. If no CTL 
statement is specified, the class is established by the 
PSTART command. If no class is specified at all, default 
class A is assigned. 


Note: When the * $$ JOB statement is coded in its 
positional form, class 0 may be coded as BG, and classes 
1 through 6 may be coded as F1 through P6. 


Up to 16 bytes of user information may be specified. If 
JLOG=YES was specified during POWER/VS generation, this 
information is printed on SYSLOG when the execution read 
task encounters an * $$ JOB statement. The POWER/SVS user 
information also appears in the POWER/VS account records 
and in separator pages. The user information must be 
specified as alphameric unless it is enclosed in single 
quotes. 


84 POWER/VS Installation Guide and Reference 


* $$ LST (* $$ PRT) Statement 


The * $$ LST {or * $$ PRT) statement Gefines the attributes of the 
intercepted list output of a POWER/VS job. LST and PRT are equivalent 
operation codes. Any number of * $$ LST statements is permitted for 
each POWER/VS job, except in a reader/writer partition, where only one 
statement for each device and for each job is allowed. If the * $$ LST 
statement is not included in the job, the default values established 
during POWER/VS generation are assumed. Additionally, when an IBM 3800 
Printer is being used, the default printer setup values established for 
the 3800 by the SETDF operator command are taken. 


Certain parameters (BURST, CHARS, COPYG, DFLT, FLASH, and MODIFY) on the 
* $$ LST statement are only valid for the IBM 3800 Printer. For more 
information on the 3800 and the use of these parameters see the DOS/VS 


ee ee 


* $$ LST statements do not require that * $$ JOB and * $$ EOJ statements 
also be used. 


The specifications of a particular * $$ LST statement remain in effect 
until a subsequent * $$ LST statement for the same printer (LST=) is 
issued, or until the end of the POWER/VS job. 


For each * $$ LST statement within a POWER/VS job, a separate list queue 
entry and job number is created (data-driven output segmentation). The 
first list entry will contain the same job number as the associated RDR 
queue entry. However, any subseauent list entries will have a unique 
job number. Repeated use of the SEGMENT macro in the same job will have 
the same effect. 


Note: Data-driven output segmentation is not supported in a writer-only 
partition. 


// ASSGN statements must have been issued for the printer referred to by 
the LST or PRT statement. 


If an error is detected in the * $$ LST (* $$ PRT) statement, the 
central operator may correct the statement during job execution. 


Positional format: 


DOr a a ee ee ee eg ee a ee ee ge Te ge, Pe Te ee ee ee ee Ss es ge aD, 
}Operation {Operands | 
ieecewimaeeene kee sae Cnn. | (= acne ia eee | 
|* $$ LST D A ,( forms-number ], | 
Jor disposition] class | 
1* $$ PRT 
| 
| 
| 
i 


eo 
tr Sle 


umber~of-copies]|,{ norbm1J,[{ linetab ] 
apeaddr 
a rr a i er eh a a ee rc eg en eee 
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Keyword format: 


fOperation JOperands 

]}* $$ LST {| DISP=/D 

Jor | disposition 
|* $$ PRT 


| 

|] -CLASS=fA 

| class 
| 


i{ ,-PRI=priority } 


1 

I{ -REMOTE=renmid } 

' evo-{ blanks_ 
forms-number 

,JSEP=(sep[ ,option }) ] 


paces | 
\ antes -of-copies 


,COPYG=(groupvaluef ,groupvalue... ]}) J 
,TADDR=tapeadar J 

»RBM= (norbat,norbm2) | 

,LTAB=linetab } 

»RBS=norbs } 

,UCS=(phasename[ ,option ]}} ] 
,FCB=phasename } 


| 
(aoe (a °\) 
[ 
[/ 


,LST=lstaddr] 


a) 


,CHARS= (tablename[ ,tablename...}) J 


,DFLT= “{k }] 


eFLASH= ({ overlayname ][ ,count J) } 


——e ES cue Gee eee ee ee eee ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee eee eee 


ES GS Se ee em ee ee re ees ee ee ce i ee ree ee ee ee wr ee ee ee re ee es ee ee ee ce ee ee ee ee ee es es ee ee 


,MODIFY=(copymodname[ ,tablenanme }) J 
nnn ere ene rt rn 


Note: The operands PRI, REMOTE, JSEP, COPYG, RBS, UCS, FCB, LST, 
CMPACT, BURST, CHARS, DFLT, FLASH, and MODIFY can only be specified in 
the keyword form of the statement. 
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DISP= 


CLASS= 


PRI= 


specifies the disposition of the printed output after 
execution of the job. The disposition specification 
options are listed below: 


D - Delete after processing. The list queue entry is 
written to a printer according to its class and 
priority. 


H - Hold. The list queue entry remains in the list 
queue; it is not written to a printer by POWER/VS 
until the operator changes the disposition to D or K 
by means of the PALTER command or issues the PRELEASE 
command. 


K - Keep after processing. The list queue entry is 
automatically written to a printer according to its 
Class and priority. When printing is completed, the 
list queue entry is not deleted from the list queue, 
and the disposition of the queve entry becomes L. 


L ~- Leave in gueve. The list queue entry remains in the 
list queue; it is not written to a printer until the 
operator changes the disposition to D or K by means 
of the PALTER command or issues the PRELEASE command. 


N - Output without spooling. If N is specified, print 
requests are not intercepted. Output is written 
directly, without spooling. In this case, all other 
parameters (except "LST = ...") are ignored. If the 
N option is specified, and the device to which SYSLST 
is assigned is not available at execution time, 
message O0P31D (device not operational) may be issued 
Crepeatedly. 


T - Spool to tape intermediate storage. PSTART is used 
to initiate printing. 


If the disposition specification is omitted, D is 
assumed. 


D, H, K, and L are only valid when the output is spooled 
to disk. 


When the output is to be printed at a terminal, N and T 
are invalid options. 


specifies the class of the printed output after execution 
of the job. It may be specified as any alphabetic 
character (A through Z). A class may be specified in 
conjunction with "forms-number" to group together the 
same types of printed output. "class" is only meaningful 
when the output is spooled to disk. If a class is 
specified and the positional form is used, a disposition 
must also be specified. If "class" is omitted, A is 
assigned. If the * $$ LST statement is omitted, an 
output class can be specified in the PSTART command. 


Note: There is no comma between disposition and class in 
the positional form. A blank must separate these two 
parameters. 


specifies the priority (0~9) of the LST output. Default 
is the priority of the job. 
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REMOTE= 


FNO= 


JSEP= 


specifies the TO remote-ID to which list output is to be 
routed. Each list queue entry also has assigned to it a 
FROM remote-ID, which identifies the user who initially 
submitted the job. The “remid" specification can be a 
number from 0 to 200. Numbers 1 to 200 represent 
specific remote users. If "remid" is 0, list output is 
directed to the central installation. If this parameter 
is omitted or if the positional form of the * $$ LST 
statement (which does not support this parameter) is 
used, list output is routed to the central location if 
the job was submitted locally, or is routed according to 
the LSTROUT specification in the PRMT macro if the job 
was submitted remotely. 


specifies the type of forms to be used according to 
installation requirements. The forms number is specified 
by one to four alphameric characters, /, -, or period 
(-)- If "forms~number" is not specified, it is assumed 
to be four blanks, representina the installation’s 
standard type of forms. When a list writer task is to 
process output from a list queue entry, it determines 
whether this forms number matches that of the previous 
list queue entry. If they match, the list writer task 
processes the output. If they do not, message 1Q40A is 
issued, or 1QA5A for the 3800 Printer. If the first 
queue entry processed after a PSTART has a forms ID of 
four blanks, no mount message is issued. If the output 
is directed to a 3741, this parameter must not be 
specified. 


A mount message is issued for FCB printers every time an 
FCB is loaded. Forms alignment is then possible. 


specifies the number of job separator pages (0 to 3). If 
not specified, the value defined during POWER/VS 
generation in the first entry of the JSEP parameter of 
the POWER macro is assumed. 


Following "sep", an option (either Y or N) can be 
specified, where: 


Y - specifies that the separator pages are also produced 
between copies of the output file. 


N - suppresses the generation of separator pages between 
each copy of an output file. 


When the option is not specified, the COPYSEP 
specification defined during POWER/VS generation is 
assumed. 


Note: This option is available only with the 3800 ICR 
and is in effect only when a nonzero specification for 
JSEP is defined, either during POWER/VS generation or in 
the * $$ LST {or * $$ PRT) statement. 


Each separator page contains the POWER/VS job name and 
number, user information from the * $$ JOB statement, and 
the date and time. Separator pages that delimit the last 
or only segment contain also the word "LAST", 


For a nonzero specification, one more page than specified 
will be printed. This is because printing may have 
occurred on the paper perforation. The page length is 
determined by the LTAB specification. 
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COPY= 


COPYG= 


TADDR= 


specifies the number of copies of printed output from the 
list queue entry. This parameter is ignored when the 
output is not spooled to disk. The parameter is 
specified by one or two digits. If omitted or 0 or 00 is 
specified, one copy is printed. If additional copies are 
required when disposition is T, the tape must be 
reprinted. 


Note: If the COPY parameter is used together with the 
RBS parameter, the page count on the printed output will 
not be in proper seguence. 


describes {for the IBM 3800 Printer) how the printed 
copies of the output file are to be grouped. Each 
*groupvalue" specifies the number of copies of each 
individual page that is to be printed in a group before 
starting to print the next page. POWER/VS retransmits 
the entire output file for each group value specified. 

Up to eight group values can be specified. The copy 
group index is used for counting of the group values. No 
Single group value can exceed 255, nor can the sum of 
those specified exceed 255. 


This parameter has effect only when the output file is 
directed to an IBM 3800 Printer. Otherwise it is 
ignored. This parameter is also ignored when the output 
is not spooled to disk. If the COPYG parameter is 
omitted, no copy grouping occurs. 


specifies the channel and unit address (and, optionally, 
the recording density) of the tape drive to be used for 
spooling to tape intermediate storage when the job is 
being executed. This parameter may be specified in one 
of the following ways: 


cuu 
XFcuu! 
(cuu,Sss) 
(X*cuu*,ss) 
(cuu,X*ss*) 
{X'cun',X*ss*). 


"ss" can only be specified in the keyword format. It 
shows the density of the output tape. The specification 
of “"tapeaddr" forces a disposition of T. If DISP=T is 
specified and "tapeaddr" is omitted, the operator is 
requested to specify the tape address during job 
execution via message 1055D. 


Two or more files can be written to a single tape. 
Multivolume files are also supported. 


Note: The output of a mnultivolume file is split at 
logical boundaries. In case of printer output, this is a 
skip to channel 1. That means that a print output that 
does not contain skips to channel 1 cannot be split into 
two or more volumes. 


The RBS parameter is not active when spooling onto tape. 
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RBM= 
norbm 


norbm2 


LTAB= 


specifies the number of lines (list records) intercepted 
before message 1052I is sent to the operator. This 
parameter is specified by one to six digits. If "norbm1" 
is omitted, the value defined during POWER/VS generation 
in the first entry of the STDLINE parameter of the POWER 
macro is assumed. 


specifies the additional number of list records inter~ 
cepted each time before message 1052I is reissued. It is 
specified by one to six digits. If “"norbm2" is omitted, 
the preceding comma and the parentheses may be omitted 
and the value defined during POWER/VS generation in the 
second entry of the STDLINE parameter of the POWER macro 
is assumed. This value is also assumed when the 
positional form of the LST statement is used. 


specifies the carriage control tape format to be used by 
POWER/VS when print reguests are intercepted for a non- 
FCB-type printer. As a default, the value of the LTAB= 
parameter specified in the POWER macro is used. This 
parameter, coded as 13 two-digit decimal values, 
represents the positions of the first line on the page 
and channels 14 through 12. Channel 14 must be the first 
channel of a page. The format is: 


d0d1d2d3d4a5d6d7d8d9d 10411412 


where dO is the number of lines between channel 12 of the 
preceding page and channel 1 of the new page; d1is the 
number of lines between channel 1 and the first line of 
the printed page, it should always be 00. a2 is the 
number of lines from channel 1 to channel 2; and finally, 
a€12 is the number of lines from channel 1 to channel 12. 
If channel 1 is the same as the first line of the printed 
page, 41 therefore is coded as 00. Similarly, if a 
channel is not represented, it must be coded 00, but 
channel 1 must always be present on the control tape or 
in the FCB. The sum of 40 and 412 is assumed to specify 
the maximum number of lines that can physically fit on a 
page. If d12 is specified as 00, a default value is 
taken from the communication region. If a skip is 
encountered to a channel that was not specified, message 
OP73I is issued. 


An LFCB macro issued in the problem program updates the 
LTAB format. 


1. It is advisable to use the "forms-number" parameter 
in conjunction with the “linetab" parameter. This 
causes the list writer task to pause, thus allowing 
the operator to mount the correct carriage control 
tape on the printer. 


2. Channel 1 on the carriage tape is used as an 
indicator for a page boundary and should therefore be 
specified. 
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RBS= 


uCS= 
or 
PCB= 


specifies the number of list pages (that is, the number 
of skips to channel 1) intercepted before the output is 
segmented (count“driven output segmentation). It is used 
only when spooling to disk intermediate storage. This 
operand is ignored if DISP=T was specified. It is 
specified by one to six digits and overrides the POWER/VS 
generation specification of the RBS= parameter of the 
POWER macro. A zero means that no segmentation will take 
place. 


When output segmentation occurs, the operator is notified 
via message 10531. 


specifies the name of the phase under which an FCB (Forms 
Control Buffer) or UCB (Universal Character Set Buffer) 
image is cataloged in the core image library. Together 
with the UCB phase name, an option may be specified which 
can be either F, C, PC, or CP, where 


F - signifies that the UCB is to be loaded with the 
folding operation code to permit printing of 
uppercase for lowercase bit configurations. 


C ~ Prevents the data checks from being generated because 
of print line mismatches with the UCB. 


The specified core image library phase is loaded into the 
FCB or UCB when a list writer task starts processing the 
output related to the * $$ LST statement. 


If ucs is coded and CHARS is not coded in the * $$ LST 
(or * $$ PRT} statement and if the output file is 
assigned to a 3800 printer, the UCS name is used as the 
first character arrangement table name. For more 
information on the CHARS parameter, see description of 
the * $$ LST statement later in this chapter. 


Return to a default UCB can only be made via a subsequent 
* $$ LST statement. 


When an * $$ LST statement with an FCB phase name 
specification is encountered by the execution processor, 
the specified buffer image is read to update the internal 
LTAB representation to reflect the new buffer. Any LTAB 
specification in the * $$ LST statement is therefore 
ignored if PCB is also specified. The FCB specification 
for a non-PC3B printer is accepted, but is only used to 
update the LTAB. For output directed to forms control 
buffer printers, POWER/VS will ensure that the standard 
FCB (depending on the printer type) is loaded if no FCB 
parameter or LST statement is supplied for the job. 


Return to a default FCB is made at the end of the 
processing of the current LST entry. 
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LST= 


When the IBM 3800 Printer is installed and the first four 
characters of the FCB phase name are $$$$, the execution 
processor changes the $$$$ depending on the device for 
which the FCB is processed. The prefixes that are 
inserted for $335 are: 


FCB1 for a 3800 Printing Subsystem 
FCB2 for a 3211 printer 
FCB3 for a 3203 printer 
PCB4& for a 5203 printer. 


This gives you device-independent processing for FCBs. 
However, when using this feature, it is still your 
responsibility to supply FCB images with phase names 
according to the above convention. 


This parameter is not supported by th2 positional form of 
the * $$ LST statement. 


When using SNA terminals or workstations for the 
production of list output, you should consider the 
following: 


As POWER/VS does not support Select Vertical Format 
(SVF), it is the responsibility of the remote operator to 
set up the vertical tab tables at the remote work 
Station. However, the FCB name is sent if PDIR is 
supported and if the name has been specified in the JECL 
statements * $$ LST or * $$ PRT. 


Note: When the output file is directed to an 3800 
printer, the first four characters of the FCB phase name 
must be FCB1. 


It is advisable to use the "forms~number" parameter in 
conjunction with the "FCB" parameter. This causes the 
list writer task to pause, thus allowing the operator to 
mount the correct Carriage control tape on the printer. 


specifies either the logical or physical address of the 
output printer for the list queue entry being created. 
The address can be either in the form SYSxxx, where xxx 
is LST or any valid programmer logical unit, or in the 
form cuu (or X*®cuut), which is the channel and unit 
number of an actual or a dummy printer. SYSxxx must be 
assigned to the correct printer before the * $$ LST 
statement is processed. If a program produces two or 
more different reports (which, in addition, may require 
different forms), this parameter must be used to define 
specific printers for each of the reports. If this 
parameter is omitted, the default is the first printer 
address specified at partition start-up. For example, if 
at start-up, the following printers were specified on 
SYSLOG: PRINTERS=00E,01E,02E, then printer 00# would be 
the default. In order to have the * $$ LST statement 
parameters take effect for printer OTE or O28, LST=O1TE or 
LST=02E must be specified. 


This parameter is not supported by the positional form of 
the * $$ LST statement. 
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CMPACT= 


BURST= 


CHARS= 


specifies the name of the compaction table to be used. 
This name may consist of 1 to 4 alphameric characters. 
If NO is specified, no compaction will be performed for 
this job. 


If the CMPACT parameter is omitted, the default 
compaction table specified in the PRMT macro will be 
used. 


This parameter applies to 3800 printers only. BURST 
Specifies whether the output printed by the 3800 is to go 
to the optional Burster-Trimmer-Stacker. Valid 
specifications are Y or N, where: 


Y ~ indicates that the printed outvut is to be burst into 
separate sheets. 


N - indicates that the output is to be continuously 
fanfold. 


When the BURST parameter is omitted, the defanlt paper 
threading request is taken (this default may have been 
established using the SETDF operator command). Also, 
when DFLT=N has been specified, BURST=N is assumed as the 
default. 


When you direct your output to the Burster-Trimmer~ 
Stacker, stacked sheets of each output file are 
automatically separated from those of the preceding file. 
Copies and copy groups are also separated. 


The BURST parameter is syntax-checked but ignored for 
printers other than the 3800. 


This parameter applies to 3800 printers only. CHARS 
specifies the character arrangement tables to be used by 
the 3800 for printing of the output file. "table name" 
specifies the 1- to 4&-character name of the character 
arrangement table (not including the system-assigned 
prefix, XTB1, of the phase name). Up to four table names 
can be specified. Por more information on character 
arrangement tables and their use, see the DOS/VS IBM 3800 
Printing Subsystem Programmer's Guide, GC26~3900. 


If CHARS is coded and UCS is not coded in the * $3 LST 
(or * $$ PRT) statement and if the output file is 
assigned to an impact printer with the UCS feature, then 
the first character arrangement table name is used as the 
uUCS name. 


The CHARS parameter is syntax-checked but ignored for 
printers other than the 3800. 
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DFLT= 


FLAST= 


This parameter applies to 3800 printers only. It 
specifies whether the IBM 3800 Printer is to be set with 
the defaults that are specified by the operator in the 
SETDF command. 


Y - specifies that the defaults previously established 
for the particular printer are to be used. The 
default values are used when the corresponding 
parameter is not specified. Defaults can be 
established by means of the SETDF command for the 
following parameters: BURST, CHARS, FCB, FLASH, FNO 
(forms), and MODIFY. 


N - specifies not to use the defaults established with 
the SETDF command, but to use the 3800's hardware 
defaults instead, when needed. 


When this parameter is omitted, DFLT=Y is the default. 


The DFLT parameter is syntax-checked but ignored for 
printers other than the 3800. 


This parameter applies to 3800 printers only. It 
specifies the 1- to 4-character name of th? forms overlay 
frame to be used by the 3800 printer. Following 
overlayname a flash count can be specified. It specifies 
the number of copies to be flashed with the overlay, 
beginning with the first copy. Any specification from 0 
to 255 is valid. If the overlay name is specified 
without a count or a comma after the name, or if the 
count value is greater than the number of copies 
specified (with the COPY or COPYG parameter), all copies 
are flashed. If the name is followed by a comma but no 
count is specified, a value of 0 is assumed as default 
(no copies are flashed). 


If a count is specified without an overlay name, the 
forms overlay frame loaded at the time of printing is 
used. If a count of 0 is specified, the operator is 
asked to load the requested forms overlay frame but the 
overlay is not flashed. 


The FLASH parameter has effect only for a 3800 printer. 
When specified for another printer, the parameter is 
syntax-checked but ignored. 


If the FLASH parameter is omitted and DPLT=Y has been 
specified, the default forms overlay name established for 
the printer by means of the SETDF operator command is 
taken. If no default forms overlay name has been 
established, or if DFLT=N was specified, no flashing 
occurs for the data set. 


When a list writer task for an IBM 3800 Printer is to 
process output from a list queue entry, it determines 
whether the overlay name matches that of the previous 
list queue entry. If they match, the list writer task 
processes the output. If they do not, message 1QA5A is 
issued, TCequesting the operator to insert that 
particular forms overlay frame into the 3800. There is, 
however, no verification by POWER/VS that the requested 
frame has been inserted. 
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MODIFY= This parameter applies to 3800 printers only. Predefined 
data can be printed on ail pages of an output file for 
the 3800 printer. The data can be specified by using the 
MODIFY parameter. 


"copymodname" specifies the 1- to 4-character name of the 
copy modification phase that was assigned when it was 
built (not including the system-assigned prefix MOD1). 


"tablename” is the 1- to 4-character name of the 
character arrangement table to be used when printing the 
copy modification text. This character arrangement table 
heed not be one of those specified with the CHARS 
parameter, if the 3800 has enough character generation 
storage. If "tablename" is not specified, the first 
character arrangement table specified or defaulted with 
the CHARS parameter is used for the copy modification. 


The MODIPY parameter is syntax-checked but ignored for 
printers other than the 3800. 


* $$ PUN Statement 


The * $$ PUN statement defines the attributes of the intercepted punch 
output of a POWER/VS job until a subsequent * $$ PUN or an end~of-job 

(* $$ BOJ or /&) statement is encountered. Any number of * $$ PUN 
statements is permitted per POWER/VS job, except in a reader/ writer 
partition, where only one statement per device and per job is permitted. 
If the * $$ PUN statement is not included in the job, the default values 
established during POWER/VS generation are assumed. * $$ PUN statements 
do not require * $$ JOB and * $$ EBOJ statements also to be used. 


For each * $$ PUN statement within a POWER/VS job, a separate punch 
queue entry and job number is created (data-driven output segmentation; 
see the section "Concepts and Functions" in Chapter 1). The first punch 
entry will contain the same job number as the associated RDR queue 
entry. However, any subsequent punch entries will have a unique job 
humber. Repeated use of the SEGMENT macro in the same job will have the 
same effect. 


Note: Data-driven output segmentation is not supported in a writer-only 
partition. 


If an error is detected in the * $$ PUN statement, the central operator 
may correct the statement during job execution. 


Positional format: 


| Operation Operands ! 
i 


— oe ee em Om owe ee fr oe oe om ee oe ee ee ee ee Fe ee ee er ee ee ee we ee ee ee a ee ee ee oe 


|* $$ PUN la A ,( forms-number}, ] 
| | {disposition | Fiaeel | | 
| | | 
| i f 
| | jnumber~-of-copies |,f{ norbm1 } | 
| | Ltapeaddar } 
ce Ne | 
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Keyword format: 


cree Gare ge ee NT ge EE LOIS eT ee a PS eS ET Re Ee ee ee a Op 
|Operation {Operands 


ce ee ee ee re ee ce ee ee ee ee ee ee eee ee ae ee ee i i a ae es ee es ee ee ee ew ee ee eee ee eee ae es 


DISP={D 
disposition 
,CLASS=fA 
class 


( -PRI=priority J 

[ -REMOTE=remid ] 

{ »-FNO=forms~number J 
C 


,JSEP= (sep[ ,option J) J 


,COPY={1 
number-of-copies 


,TADDR=tapeaddr[ ,X*ss*}] 


sRBS=norbs j 


Ok ek ee eee 


C 
{ -RBM=(norbm1,norbm2) ] 
C 
{ -PUN=punaddr J 


Note: The operands PRI, REMOTE, JSEP, RBS and PUN can only be specified 
in the keyword form. 


DISP= specifies the disposition of the punched output after 
execution of the job. The disposition specification 
options are listed below. D, H, I, K, and L, are only 
valid when the output is spooled to disk. When the 
output is punched at a terminal, N and T are invalid. 


D - Delete after processing. The punch queue entry is 
automatically written to a punch according to its 
class and priority. 


H ~ Hold. The punch queue entry remains in the punch 
queue; it is not written to a punch by POWER/VS until 
the operator changes the disposition to D or K by 
means of the PALTER command or issues the PRELEASE 
command. 


I - Return output to input queve. In some situations it 
may be useful to return the punch output of a 
POWER/VS job directly to the input queue. For 
example, the assembler normally stores its output 
(including JCL) on tape, for subsequent input to a 
catalog run; under POWER/VS however, it can store 
output directly in the input queue. 
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CLASS= 


PRI= 


REMOTE= 


The newly~built input queue entry has the same 
jobname, remote-ID, and priority as the entry that 
produces the output. Class becomes that specified in 
the * $$ PUN statement; disposition becomes D. This 
facility should only be used for jobs producing punch 
output in executable format. 

The I option is ignored in a writer~only partition. 
The option suppresses count-driven output 
segmentation and also ignores the multiple-copies 
specification. 


K - Keep after processing. The output is automatically 
written to a punch according to its class and 
priority. When punching is complete, the punch quetie 
entry is not deleted from the punch queue, and the 
disposition of the queue entry becomes L. 


L - Leave in queue. The job remains in the punch queue; 
it is not written to a punch until the operator 
changes the disposition to K or D by means of the 
PALTER command or issues the PRELEASE command. 


N - No spooling. If N is specified, punch requests are 
not intercepted. It allows direct writer 
capabilities without spooling. If the N option is 
specified and the device is not available at 
execution time, message 1046I is issued and punch 
output is spooled. 


T - Tape spooling. The output is spooled to tape that is 
used as intermediate storage. 


specifies the class of the punch output of the job. It 
may be specified as any alphabetic character (A through 
Z). “class" may be used in conjunction with "forns- 
number" to group together the same types of punch output. 
Punch tasks can be specified by class to process the 
output. A class specification is only meaningful when 
the output is spooled to disk. 


If "class" is specified and the positional form is used, 
"disposition" must also be specified. If "class" is 
omitted, class A is assigned. If the * $$ PUN statement 
is omitted, an output class can be specified in the 
PSTART command. 


Note: There is no conma between “disposition” and 
"class" in the positional form. 


specifies the priority (0-9) of the punch output. If 
omitted, the priority of the job is taken as default. 


Specifies the TO remote-ID to which punch output is to be 
routed. Each punch queue entry also has a FROM remote-ID 
assigned to it, which identifies the user who initially 
submitted the job. "remid™ can be a number from 0 to 
200. Numbers 1 to 200 are specific remote users. If 
"remid" is specified as 0, punch output is directed to 
the central installation. If this parameter is omitted 
or if the positional form of the * $$ PUN statement is 
used, punch output is routed to the central location for 
locally submitted jobs or is routed according to the 
PUNROUT specification in the PRMT macro for jobs 
submitted remotely. 
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PNO= 


JSEP= 


COPY= 


specifies, by one to four alphameric characters, /, ~-, OTF 
period (.), the type of card forms to be used. If a 
forms numbe: is not specified, it is assumed to be four 
blanks, representing the installation's standard type of 
card forms. When a punch writer task is to process 
output from a punch queue entry, it determines whether 
this forms number matches that of the previous punch 
queue entry. If they match, the punch writer task 
processes the output. If they do not match, message 
10O40A is issued. If the first queue entry processed 
after a PSTART has a forms ID of four blanks, no nount 
message is issued. If the output is directed to a 3741, 
this parameter must not be specified. 


specifies job separation. 0-9 can be specified. If 0 is 
specified, no job separation occurs. Job separation 
means that before the job's punched output one card con- 
taining the POWER/VS jobname (punched so that it can be 
read on the back of the card) and from two to eight cards 
containing 12-11-0-8-9 punches (in all 80 columns) are 
added and that behind the job's punched output two blank 
cards are added. This occurs if 1, 2, or 3 is specified. 
If 4 is specified, one additional 12-11-0-8-9 card is 
punched; if 5 is specified, two additional 12-11-0-8-9 
cards are punched, and so on. 


Note: Stacker selection is ignored if job separation is 
requested. The default stacker for the given device is 
used instead. 


If the 3800 ICR is installed, an option (either Y or N) 

can be specified following the "sep" parameter, where: 

Y - specifies that separator cards are also included 
between copies of each punch output. 


N - suppresses the inclusion of separator cards between 
copies of the punch output. 


When the option is not specified, the COPYSEP 
specification defined during POWER/VS generation is 
assumed. 


Note: The option is only in effect when a nonzero JSEP 
specification is defined, either during POWER/VS 
generation or in the * $$ PUN statement. 


specifies the number of copies to be punched from the 
punch queue entry. The parameter is specified by one or 
two digits. If it is not specified, 1 is assumed. If 0 
or 00 is specified, one copy is punched. This parameter 
is ignored when the output is not spooled to disk. If 
additional copies are required when the disposition is T, 
the tape must be repunched. 
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TADDR= 


RBM= 
norbnt 


norbr2 


RBS= 


PUN= 


specifies the channel and unit address (and, optionally, 
the recording density) of the tape drive to be used for 
spooling when the job is executed. Its format may be 
specified in one of the following ways: 


cuu 
X*cuu® 
({cuu,ss) 
(X*cuu*,ss) 
(cuu,X"ss*) 
(X*®cuu’,X*ss*). 


"ss" can only be specified in keyword format. It shows 
the density of the output tape. The specification of 
“tapeaddr" forces disposition T. If DISP=T is specified 
and "tapeaddr" is omitted, the operator is requested via 
message 1055D to specify the tape address at job 
execution time. 


Two or more files can be written to a single tape. 
Multivolume files are also supported. 


specifies the number of punch records intercepted before 
message 1052I is sent to the operator. This parameter is 
specified by one to six digits. If "norbm1" is omitted, 
the value defined during POWER/VS generation in the first 
entry of the STDCARD parameter of the POWER macro is 
assumed. 


specifies the additional number of punch records 
intercepted before message 10521 is issued again. It is 
specified by one to six digits. If "norbm2" is omitted, 
the preceding comma as well as the parentheses may be 
omitted and the value defined during POWER/VS generation 
in the second entry of the STDCARD parameter of the POWER 
macro is assumed. This value is also assumed if the 
positional form of the * $3 PUN statement is used. 


specifies the number of punch records intercepted before 
the output is segmented (count-driven output 
segmentation). It is used only when spooling to disk 
intermediate storage. This parameter, which is ignored 
if DISP=T was selected, is specified by one to six digits 
and overrides the POWER/VS generation specification of 
the RBS parameter of the POWER macro. A zero means that 
no segmentation will take place. When output 
segmentation occurs, the operator is notified via message 
10531. Por segmentation on a 3525, and if print commands 
are used, all segments must be punched in a row, or 
separator cards must be specified. This is necessary to 
ensure that the last two records will not be lost. 


specifies either the logical or physical address of the 
output punch for the punch queue entry being created. 
The address can be either in the form SY¥Sxxx, where xxx 
is PCH or any valid programmer logical unit, or in the 
form cuu (or X*cuu'), which is the channel and unit 
number of an actual or a dummy punch. If this parameter 
is omitted, the default is the first punch address 
specified at partition start-up. This parameter is 
needed when two or more punches are used to punch two or 
more card files produced by a single progran. 
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The * $$ RDR statement is used to insert a 3540 diskette file into input 
being read from the card reader. There are two modes of input 
processing, which are: 


1. SYSIN-mode processing; the physical unit number of the 3540 diskette 
device must not be specified. The file to be read from the diskette 
must contain 80- or 81~byte records. Only the last 80 bytes of an 
81-byte record are passed to the reader. The file to be read from 
the diskette must contain the necessary JECL and/or JCL job stream 
if the POWEBR/VS command PSTART RDR does not specify both card reader 
and 3540 physical unit addresses. 


2. Data-~mode processing; the physical unit number of the diskette from 
which the input data file is read must be specified. The JECL 
and/or JCL statements are read from the card reader. If two or more 
RDR statements are issued in one POWER/VS job, they must specify the 
same physical unit number. 


ote: In a writer-only partition, this statement is ignored. 


Positional format: 


Sa Pe gee eS ign se ee a ae aS, | 
}Operation |Operands I 
ee nee | 
|* $$ RDR I{ diskette-addr]J,{ *file-id'"J,/1 LS) I 
| | number-of-diskettes | 


Te | 


Keyword format: 


Ce ne ee ee ee ee ee ee 
jOperation {Operands 


ee ee ee a ee ee a ee i eee a ee ee ee eee ee ee eee ee ewe we ee ee eee eM ewe ee ew es ee ee ew ew ew ew ee we 


* $H RDR {( DEV=diskette-addr] 


| 
I{ -FID="file-id’] 


| 
! 
] 
| 
| 
| 
| 
| 
| 
| 
| 
I 
l 
| 
| 


Note: The operands VER and FEED can only be specified in the keyword 
m 


form of the statement. 


100 POWER/SVS Installation Guide and Reference 


DEV= 


FID= 


NOD= 


vVsc= 


VER= 


FEED= 


specifies the physical unit number (X*cuu® or cuu) used 
by the user program to read the input data file. The 
physical unit must not be specified for SYSIN files, In 
one POWER/VS job, more than one RDR statement can be 
specified to insert more than one 3540 data file, but the 
different RDR statements must indicate the same physical 
unit number in the DEV parameter. 


specifies the file name (in quotes) as it appears in the 
HDR1 label on the 3540 diskette. One to eight alphameric 
characters can be specified. If this parameter is 
omitted, POWER/VS reads the file specified by the first 
hon-secured HDR? label found on the diskette that is 
currently mounted. The size of the record to be read is 
taken from the HDR1 label. 


specifies the maximum number of diskettes to be read. 

One to three digits can be specified. Allowed values are 
1 to 255. The default value is 1. Reading stops after 
the specified number of diskettes are processed, or after 
reading a diskette whose HDR1 label indicates that it was 
the last volume of the file. 


specifies whether volume sequence checking is desired. 
If omitted, no sequence checking will take place. 
Sequence numbers must start with 1 and must be 
incremented by 1 up to a maximum of 99. 


specifies optional file verification. If VER=YES is 
specified, POWER/VS checks that file verification had 
been performed on the diskette file (verify field in the 
HDR? label of the file set to 'V'}. If VER=YES and the 
verify field was not set to 'V', the file is rejected 
during file OPEN. If VER=NO or if the parameter is 
omitted, the verify field in the HDR? label is ignored 
during processing. 


specifies the option to eject and feed a new diskette at 
end-of-file of the preceding diskette. This parameter 
can be used in combination with the FEED parameter of the 
POWER macro instruction. During the POWER/VS generation, 
you have established the system default value for the 
FEED option (YES or NO); this system default can be 
overridden by the FEED parameter of the * $$ RDR JECL 
statement. Any time a * $$ RDR statement is going to be 
processed, the FEED parameter is reset to the system 
default as specified in the POWER macro instruction. 


* $$ SLI Statement 


During program execution, the * $$ SLI statement causes the private and 
the system source statement library to be searched for a book, which, 
when found, is inserted into the job stream. The private source 
statement library, if assigned to the POWER/VS partition, is searched 


first. 


An * $$ SLI statement does not require that * $$ JOB and * $$ EOJ 
statements also be used. 
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Statements may be added to or deleted from the source statement library 
books. Such update statements may be inserted before or after SSL 
statements or may replace or delete them. They have special codes in 
columns 73-80: 


columns 73-76 contain "$SLI®* 
columns 78-80 contain a sequence number 
column 77 contains a special code: 


A = Insert after book statement with the same 
nupber or before the one with the next higher 
seguence number. 


B = Insert before book statement with equal or 
higher sequence number. 


D - Delete the book statement with the same 
Sequence number. 


Other = Replace the book statement with same seguence 
number or insert this statement. 


Source statement library update statements and * $$ DATA statements, 
when used, must follow the * $$ SLI statement in the same sequence as 
the statements in the book they correspond to. 


Books are cataloged into the source statement library with the DOS/VS 
program MAINT. To include /* and /& statements in a book, submit thea 
as * $$/* and * $$/& statements since /* and /& statements are not 
accepted as data by MAINT. To include LST and PUN statements, submit 
them as * $x LST or * $x PUN, where x can be any character other than 
blank or $. If the book is not found in the specified sublibrary, 
message 1044I is issued and the job is flushed. 


Ce a a ee ee en ee ee eT ee eee eee ee ee ee 
}Operation {Operands ! 


I 
1* $$ SLI [{ sublib. Jbookname l 
ae a a nC Oe | 


Note: This statement is only available in the positional format. 


sublib. specifies the name of the sublibrary to be searched. 
Valid sublibrary names are A through Z, 0 through 9, $, 
#, or @, followed by a period (.). Sublibraries A, C, D, 
E, F, and Z are already defined as special-purpose 
libraries in DOS/VS. This parameter is optional. If 
omitted, the sublibrary specification at POWER/VS 
generation is used. 


bookname specifies the book name to be searched for and inserted 
into the job stream. If "bookname" begins with $$, it 
will be changed depending upon the partition in which the 
SLI book is being processed. $$ becomes $B in BG or $n 
in the foreground partition Fn. 
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The following examples illustrate the use of the * $$ SLI and * $$ DATA 
statements: 


1. 


Job to insert data from the card reader into the book "ASSM", 


Job_ from card reader Source book "ASS" 


* $$ JOB INSERT BKEND ASSM 

* $$ SLI ASSM // JOB INSERT 

* $$ DATA INPUTA // BXEC ASSEMBLY 
POWER ACCOUNT=YES * $$ DATA INPUTA 
END * $$/3% 

/* BKEND 

* $$ EOJ 


Resulting job _ stream 


// JOB INSERT "ASSM") 
// EXEC ASSEMBLY "NASSM") 
POWER ACCOUNT=YES reader) 
END reader) 
/* reader) 
/& WASSM") 


Assume that a private source statement library is assigned to the 
POWER/VS partition. A job {read in from the card reader) references 
the book "XMPL" in that library (sublibrary B) and contains SL 
update statements as well as DATA statements. The book statements 
replace the SLI statement. However, statempents XMPL0020, XMPLO100, 
and XMPL0120 are overridden by the corresponding SL update 
statements in the input stream. In addition, statement $SLIA100 is 
inserted. Also, the cards between the DATA statement and the first 
/7* statement in the input job stream replace the DATA statement in 
XMPL. The resulting job stream is placed in the read queue. 
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104 


Job from ca 


* $$ JOB 
* $$ SLI 
// ASSGN 
* $$ DATA 


DEFAULT POWER ACCOUNT=YES 


END 
/* 
// ASSGN 
// ASSGN 


ff MTC 
* $$ EOJ 


// ASSGN 
// EXEC 

* $$ DATA 
// MTC 
// MTC 
// MTC 

* $$/& 
// JOB 
// ASSGN 
// EXEC 
// MTC 

* $$/* 

* $S/& 
// JOB 
// OPTION 


rd reader 


ASSEMSLI 
B.XMPL 
SYSPCH,X*182° 
INPUTA 


SYSIPT,X*1382° 
SY¥S010,xX"1483° 
RON,X'182° 


B.XMPL 
ASSEMBLE 
SYSPCH,X*180! 
ASSEMBLY 
INPUTA 
WIM,SYSPCH 
WIM, SYSPCH 
REW, SYSPCH 


CATALOG 
SYSIPT,X*180* 
MAINT 
RUN,X'180° 


LINK 
CATAL 


INCLUDE DEFAULT 


* $$/* 
// EBXEC 
* $$/8& 
BKEND 


LNKEDT 


Col. 73-80 


$SLI0020 


SSLIO100 
$SLIA100 
$SLI0120 


Col. 73-80 


XMPLOO10 
XMPLO00Zz0 
XMPLO0030 
XMPLOO4O 
XMPLO050 
XMPLO0060 
XMPLOO070 
XMPL0080 
XMPLO0090 
XMPLO100 
XMPLO110 
XMPL0120 
XMPLO130 
XMPLO 140 
XMPLO150 
XMPLO160 
XMPLO180 
XMPLO200 
XMPLO210 
XMPLO220 
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Resulting job stream placed in read queue 


Col. 73-80 

* $$ JOB ASSEMSLI 
// JOB ASSEMBLE XMPLOO10 
// ASSGN SYSPCH,X*182* $SLI0020 updated 
// EXEC ASSEMBLY XMPL0030 
DEFAULT POWER ACCOUNT=YES inserted ] 

END inserted 
/* inserted 
// MTC WIM,SYSPCH XMPLO050 
// MTC WIM,SYSPCH XMPLO060 
// MTC REW,SYSPCH XMPLO070 
/& XMPLO0080 nodified 
// JOB CATALOG XMPLO0090 
// ASSGN SYSIPT,X*182* $SLI0100 updated 
// ASSGN S$Y¥S010,X* 183? $SLIA100 inserted 
// EXEC MAINT XMPLO110 
Jf MTEC RUN,X*182* $SLI0120 updated 
f* XMPLO130 modified 
/& XMPLO140 modified 
// JOB LINK XMPLO150 
// OPTION CATAL XMPLO160 

INCLUDE DEFAULT XMPLO180 
/* XMPLO200 nodified 
// EXEC LNKEDT XMPLO210 
/& XMPLO220 modified 


Bl Aa re SY PET a Se le A 


The end-of-jobstep and end-of-job statements are used to delimit DOS/VS 
job definitions within the source statement library books (see the 
* $$ SLI statement above). 


The end-of-jobstep statement delimits DOS/VS job definitions within the 
source statement library books. 


ee ee ee ee ae pe a eT Ee ee Te Ee ee 
[Operation ]Operands | 


This statement has no operands. 


The end-of-job statement delimits DOS/VS jobs within the source 
statement library books. 


ae NS eg a EE eR re a ee a ee ee ee he ee 
{Operation JOperands t 


| 
{* $$ /& | I 
ier a pcmcia lie mat elm hg a lit cy ccm ope paiement pg ses ea tens AD 


This statement has no operands. 
otes 


Ls? and PUN statements within the SLI books may not be continued 
from one record to the next. 


N 
he 
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2. The following rules and restrictions must be considered: 
° Nested SLI statements are not permitted. 
* An SLI book may invoke a DOS/VS procedure. 
°e A DOS/VS procedure may not invoke an SLI book. 
e Each SLI book represents a POWER/VS procedure and may not include 
embedded * $$ JOB statements. However, one POWER/VS job may 


include two or more SLI statements. 


e * $$ LST and * $$ PUN statements may not be continued in an SLI 
book. However, there is no restriction on the use of // JOB, 
* $$ /*, and * $$ /& statements. 


e SYSRDR, SYSIPT, and SYSIN cannot be reassigned within an SLI 
book. 


3. The private source statement library containing the SLI books must 
be assigned to the POWER/VS vartition before POWER/VS is started. 


Cross-Partition Communication Macros 


This section describes the macros that allow access to POWER/VS 
functions from a partition not controlled by POWER/VS. These macros can 
be used only if SPOOL=YES was specified in the POWER macro during 
POWER/VS generation, and if XECB support was specified during DOS/VS 
generation. 


POWER/VS answers spooling requests originating from the SVA; however, 
the DTFs (or CCBs), CCWs, and data areas must reside in a partition and 
not in the SVA. 


To connect to POWER/VS, use the XECBTAB macro with the following 
operands: 


XECBTAB TYPE=DEFINE, 


ICRXECB 


ee 


ACCESS=X8#AIT 


SPMXECB is reguired for the GETSPOOL and CTLSPOOL macros; ICRXECB is 
reguired for the PUTSPOOL macro. The 3-byte address of the SPL must be 
placed in SPMXECB*+5 and/or ICRXECBt5S by the user program. 


Notes: For each program using the GETSPOOL, PUTSPOOL, and CTLSPOOL 
macros, the specification of the SPL TYPE=MAP macro is required. 


If the partition using the cross-partition support has a higher priority 
than POWER/VS, a system error may be issued if an abnormal end or shut 
down occurs before all cross-partition active tasks have completed. 


If.the cross-partition user issues JECL statements to POWER/VS through 
the support macros, the format is not variable. Only one blank must 
appear between the "*" and "$$" and the first parameter. 


Only one partition may actively use the cross-partition support at a 
time. 
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MACRO DESCRIPTIONS 


SPL Macro 


The SPL (Spool Parameter List) macro creates a parameter list for the 
PUTSPOOL, GETSPOOL, and CTLSPOOL macros. 


ne ee cna TE ast ae ea Ee Oe Gd De a ee Ee ee ee a ee ee a ee ged 


* 


,CBUF=firstbufaddr J} 


,PBUF=bufaddadr j 


* 


“7 “7 
* 
| hme 


{Name |Operation {Operands }Col | 
| | 72 | 
}{ name ]}SPL | TYPE=DEFINE wm*Fl 
| | | | | 
| ! t{ -JOBN=jobname J 1c *JI 
! I i ! I 
| | If ,DISP=disposition J It* JI 
| i | I | 
| I{ ,CLASS=class J tC *J1 
! ! i 

| | 1 PRI 

| | { DISP 

| | CLASS 

{ | REMOTE 

! t I{ -REQ=)CANCEL (J [*] 
j | SCRATCH 

| | ! STATUS 

l | { COMMAND 

| | | 

| | } 

| | | 

| | | 

| l 1 

| ! | 

| t | 

1 1 | 


{ ,PBUFL=buflength j 
{ 


sNEWVAL=value } 


or 


i[ name ]]SPL } TYPE=MAP (c*Vl 
| | J | ] 
| | I{ »SPHXECB=fYES }] (II 
| | | NO } rf 
! | I | 
| | |{ ICRXECB= {res }) { ! 
| ! | NO I ! 
| a ceaeareecee | 


Programming Notes 


TYPE= causes, with the specification DEFINE, a varameter list 
to be initially set up with the keywords and values to be 
used in the PUTSPOOL, GETSPOOL, and CTLSPOOL macros. 
These values can later be changed by specifying the 
corresponding keywords in the macros themselves. 


With the specification MAP, this operand causes a DS=CT 
of the SPL to be generated. TYPE=MAP must be specified 
once in every program using GETSPOOL, PUTSPOOL, CTLSPOOL. 
If TYPE=MAP is specified, only the parameters SPMXECB= 
and ICRXECB= (see below) may be coded. 
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JOBN= 


DISP= 


CLASS= 


REQ= 


CBUF= 


PBUF= 


PBUFL= 


NEWVAL= 


specifies a unigue job name to be assigned to the 
POWER/VS input queue. If omitted, the default name is 
DUMMY. 


specifies the output disposition code for the submitted 
job as it will appear on the POWER/VS output gueve. If 
omitted, the default is K. 


specifies the POWER/VS output class (A-Z) for the 
submitted job as it will appear on the POWER/VS output 
queue. If omitted, the default is A. 


specifies the requested operation for a CTLSPOOL macro. 


PRI alters the priority of the named job on the output 
queue (see note below). 


DISP alters the disposition of the named job on the 
output queue (see note below). 


CLASS alters the job class of the job on the output queue 
{see note below). 


REMOTE alters the ‘remote terminal identification to which 
list output of the job is to be routed (see note below). 


CANCEL causes the job to be cancelled from the input 
queue if it has not yet executed. 


SCRATCH causes the named job to be deleted from the 
POWER/VS output queue. 


STATUS causes the disposition of the named job on the 
input or output queue to be returned in the SPQD field of 
the SPL, and the queve indicator in the SPSQ field. 


COMMAND indicates that you have supplied a valid POWER/VS 
command in the PBUF area. 


Note: If PRI, DISP, CLASS or REMOTE are used, the 
NEWVAL= operand must also be specified. 


specifies the address of the first buffer containing the 
job stream. The format of each 88-byte buffer area is as 
follows: a four-byte pointer to the next buffer in the 
chain {or 0 for the last buffer), four bytes reserved, 
and an 80-byte data buffer area. 


specifies the address of a buffer area which is for use 
by POWER/VS and for POWER/VS feedback information on 
certain error conditions. The length of this buffer area 
must be at least 88 bytes. 


indicates the length of PBUF. It must be set to the 
maximum length of the output data records, with trailing 
blanks truncated. The minimum allowed is 88 bytes. If 
omitted, the default is 88 bytes. 


indicates the new value that is to be assigned to the 
PRI, DISP, CLASS, or REMOTE attribute of the job named in 
a CTLSPOOL request. The meaning of the one-byte value 
depends on the REQ operand. 
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SPMHXECB= 
and 
[ ICRXECB= specify that a DSECT for each of these XECBs is to be 
generated. The format of the DSECTs is as follows: 


DSECT XECB FOR GETSPOOL AND CTLSPOOL 
SPMXECBUD DS F XECB 
SPMERROR DS x ERROR RETURN CODE 
SPMSPLP DS AL3 SPL pointer 


DSECT XECB FOR PUTSPOOL 
ICRXECBU DS Fr XECB 
ICRERROR DS x ERROR RETURN CODE 
ICRSPLP DS AL3 SPL POINTER 


PUTSPOOL Macr 


The PUTSPOOL macro is used to submit a job stream from the user's buffer 
area to the POWER/VS input queue for later execution in a partition 
under control of POWER/VS. 


Only the statements of the initial PUTSPOOL job stream are analyzed for 
the existence of any POWER/VS JECL statements, in particular * $$ JOB, 
LST, or PRT statements. If no JECL statements are detected at the 
beginning of the initial PUTSPOOL job stream, * $$ JOB and LST/PRT 
statements are built in accordance with the given SPL parameters. If 
any JECL statements are encountered at the beginning of the initial 
PUTSPOOL job stream, they are first placed in the input queue, and then 
any missing * $$ JOB and/or LST/PRT statements are constructed. 


| * $3 RDR statements cannot be submitted using the PUTSPOOL macro. 
Note: When register notation is allowed for parameters of this macro 
{indicated by "{reg)" as a possible parameter value), any general 
register except registers 0, 1, 14, and 15 may be specified. 
The register contains the parameter value, except for JOBN, whose 


register must point to an eight-byte field with the jobname right~ 
adjusted. 


OO OV_OOMMYD OY 


{ ,CLASS=fclass \] 
(reg) 


j|Name [Operation |Operands iCol] 
| | | }72 
1{ name ] | PUTSPOOL | SPL= (reg) if * J! 
I | | | I 
| | I{ »JOBN= fjobnane) J Ic *II 
| I I (reg) \ i | 
| | | ! | 
I I{ ,PBUF= bufadar }] IC *]1 
| ! | (reg) I I 
1 | l ! ! 
| | scorer tees ia 
! I I{ -DISP=fdisposition) J] 1 * JI 
| | | (reg) | I 
! ! | I I 
| | | 1£*I]1 
I | i I ! 
| ! | l | 
! I | 1 | 
| I | I j 


f ,CBUF= ee 


(reg) 
Cred PC ge a a Pe CE aE TP TE EN ERR EEL TE PNET | 
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as 


JOBN= 


PBUF= 


CONT= 


DISP= 


CLASS= 


CBUP= 


ogramming Notes: 


specifies the macro label. Required if the CONT 
parameter is specified. 


specifies the address of the spool parameter list (SPL) 
to be used by the PUTSPOOL macro. The SPL defines the 
POWER/VS request for the job stream indicated by the JOBN 
operand. 


specifies a unique job name to be assigned to the 
POWER/VS input gueve. The same name must be used for the 
output queue when it is referenced by the GETSPOOL or 
CTLSPOOL macros. 


specifies the address of a buffer area which is for use 
by POWER/VS and for POWER/VS feedback information on 
certain error conditions. The length of this buffer area 
must be at least 88 bytes. 


If the buffers processed by this execution of PUTSPOOL do 
not contain the complete job stream, this operand should 
be used to give the address of a continuation routine. 

In this routine, you can submit further data buffers 
associated with the same job stream. However, no other 
parameters may be changed in the continuation routine, 
Return to POWER/VS is via register 14. When this 
parameter is used, CBUF= must also be specified and the 
macro must have a label. 


specifies the output disposition code for the submitted 
job as it will appear on the POWER/VS output queue (LST 
or PUN). The disposition must be a valid POWER/VS 
disposition. If you supply a * $$ LST or * $$ PRT 
statement, it must contain the same disposition code. 


specifies the POWER/VS output class (A-Z) for the 
submitted job as it will appear on the POWER/VS output 
queue (LST or PUN). Specify a unigue class if you want 
to have controlled access to the file(s) by means of 
GETSPOOL. If you supply a * $$ LST or * $$ PRT 
statement, it must contain the same output class. 


specifies the address of the first buffer containing the 
job stream. The format of each 88-byte buffer area is as 
follows: a four-byte pointer to the next buffer in the 
chain (or 0 for the last buffer), four bytes reserved, 
and an 80-byte data buffer area. If the CONT operand is 
specified together with CBUF, the same buffers must be 
reused for the continuation data. If register notation 
is used, the continuation routine must reset the contents 
of the previously used register if different buffers are 
used. 
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The GETSPOOL macro is used to request retrieval of list output currently 
held in POWER/VS output gueues on disk. The output is to be returned to 
the buffer area of the partition issuing the GETSPOOL macro. Retrieval 
may be sequential or direct. 


GETSPOOL can request list output only if the disposition of the queue 
entry is D or K. However, as for a list task, the disposition of the 
queue entry is changed to L after processing. Therefore, before a 
subsequent GETSPOOL request can be issued, the disposition of the entry 
has to be changed back to D or K, using the CTLSPOOL macro. 


Note: When register notation is allowed for parameters of this macro 
{indicated by "(reg)" as a possible parameter value), any general 
register except registers 0, 1, 14, and 15 may be specified. 


The register contains the parameter value, except for JOBN, whose 
register must point to an eight-byte field with the jobname right- 
adjusted. 


{Name |jOperation jfOperands }Col | 
| ' | 172 ! 
}{ name ]|GETSPOOL | SPL=(reg) iC * I 
| | ! ! | 
| | 1{ -JOBN= fjobnane) J 1*)I 
! | | (reg) } | | 
| | | 
" 1 iC Sede (hr j 1c*II 
} | | - Ureg) | | 
] I ! | | 
! ! I{ -PBUF=(bufaddr} J it *JI 
! ! | (reg) \ l j 
I ! ! [ ' 
| | I( ,PBUFL=[(buflength) ] ic*dI 
| | ! (reg) } r 4 
I | | I ! 
j " if -cc= ioe ic *Jt 
i | | NO | | 
| t | ! | 
| | if »,LINEWO= cae | | 
| | | (reg) | I 
On eee a ae ee 


Programming Notes: 


SPL= specifies the address of the spool parameter list (SPL) 
to be used by the GETSPOOL macro. The SPL defines the 
POWER/VS request for the job stream indicated by the 
JOBN= operand. If the LINENO= operand was used in a 
previous direct GETSPOOL request, the same SPL must be 
specified in the present request, or line positioning 
will be Lost. 


JOBN= specifies the POWER/VS job name for the job stream as 
assigned by PUTSPOOL. If the LINENO= operand was used in 
a previous direct GETSPOOL request, the same job name 
must be specified in the present request, or line 
positioning will be lost. 


CLASS= Specifies the POWER/VS output class (A-Z) as assigned by 
PUTSPOOL. 
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PBUF= 


PBOFL= 


cc= 


LINENO= 


ee ee ee ee ee 


specifies the address of a buffer area which is to 
receive the retrieved output record and/or POWER/VS 
feedback information on certain error conditions. If 
this operand is used, PBUFL= must also be specified. 


indicates the length of PBUF. It must be set to the 
maximum length of the output data records, with trailing 
blanks truncated. The length of the output data record, 
with trailing blanks truncated, is returned in the 4-byte 
SPRL field of the SPL. The minimum allowed is 88 bytes. 


If CC=YES is specified, the command code of the CCW 
associated with this data record is returned in the SPCC 
field of the SPL. If the record is a control record, the 
buffer contains blanks; if it is a data record, the SPCC 
field is always updated. 


If this is the first GETSPOOGL request, sequential 
retrieval of the output records begins at the line 
specified (relative to the beginning of the output file), 
or, if LINENO= has been omitted, from the beginning of 
the file. Since any subsequent GETSPOOL request would 
reposition to the line number specified, the LINENO= 
operand should be omitted for subsequent sequential 
retrieval. 


The CTLSPOOL macro is used to 


* Alter the attributes of a POWER/VS job 


e Cancel a submitted job prior to its execution 


e Delete the list output of a job after its execution 


e Display the status of a ‘job 


e Issue a valid user-supplied POWER/VS command. 


Note: 


When register notation is allowed for parameters of this macro 


(indicated by "(reg)" as a possible parameter value), any general 
register except registers 0, 1, 14, and 15 may be specified. 


The register contains the parameter value, except for JOBN, whose 
register must voint to an eight-byte field with the jobname right- 


adjusted. 


112 POWER/VS Installation Guide and Reference 


SSS ee Se a ere 
|Name |Operation [Operands }Col | 


ee te em oe Oe ee ee ee ee ee ee ee ee re ee ee em eee ee ee ee we we we we we es ee er ee a ee a we ie a 


{ nawe }]|CTLS POOL | SPL= (reg) 


a ore 
* 


| 
I{ -JOBN= aaa 
J (reg) 


| 
[ ,PBUP= tied a 
(reg) 


| 

| 

| PRI 

| DISP 

| CLASS 
| REMOTE 
If ,REQ=(CANCEL ?} 
| 

| 

I 

| 

| 

! 


_ 
* 
nnd 


SCRATCH 
STATUS 
COMMAND 


(reg) 


{ ,NEWVAL=fvalue)\] 
(reg) 


SPL= 


JOBN= 


PBUF= 


REQ= 


specifies the address of the spool parameter list (SPL) 
to be used by the CTLSPOOL macro. The SPL defines the 
POWER/VS reguest for the job stream indicated by the 
JOBN= operand. 


specifies the POWER/VS job name for the job stream as 
assigned by PUTSPOOL. 


specifies the address of a buffer area which is for use 
by POWER/VS and for POWER/VS feedback information. The 
length of this buffer area must be 88 bytes. 


specifies the requested operation as follows: 


PRI alters the priority of the named job on the output 
queue (see note below). 

DISP alters the disposition of the named job on the 
output queue (see note below). 

CLASS alters the job class of the job on the output queue 
{see note below). 

REMOTE alters the remote terminal identification to which 
list output of the job is to be routed (see note below). 
CANCEL causes the job to be cancelled from the input 
gueue if it has not yet executed. 

SCRATCH causes the named job to be deleted from the 
POWER/VS output queue. 

STATUS causes the disposition of the named job on the 
input or output queue to be returned in the SPQD field of 
the SPL, and the queue indicator in the SPSQ field. 
COMMAND indicates that you have supplied a valid POWER/VS 
command in the PBUP area. 

(reg) indicates that the request code is provided in a 
general register. You may specify one of the following 
codes in this register: 
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X*0OT* (PRI) ~ Alter routing priority (PALTER) 
X'O2* (DISP) Alter routing disposition (PALTER) 
X*'Ou" (CLASS) Alter routing class (PALTER) 

X*O08* (REMOTE) Alter routing remote-ID (PALTER) 


' 


X*10" (CANCEL) - Cancel input (PDELETE RDR) 
X*20* (SCRATCH) - Scratch output (PDELETE LST) 
X*4O" (STATUS) - Display status of job (PDISPLAY) 


X*80" (COMMAND) 


Issue POWER/VS command. 


Note: If PRI, DISP, CLASS, or REMOTE are used, the 
NEWVAL= operand must also be specified. 


NEWVAL= indicates the new value that is to be assigned to the 
PRI, DISP, CLASS, or REMOTE attribute of the named job. 
The meaning of the one-byte value depends on the REQ 
operand and can be as follows: 


For PRI, the new priority of the job 
For DISP, the new disposition of the job 
Por CLASS, the new class of the job 
For REMOTE, the new terminal identifier. 


The value specified can be either a character (for 
example, NEWVAL="A') or a number {for example, 
NEWVAL=16). If register notation is used, all values 
must be hexadecimal. 


Note 
1 


fol 


: When using the CTLSPOOL macro, you may specify one of the 
owing POWER/VS operator commands: 


e PALTER (A) command 

e PCANCEL (C) command 

® PDELETE (L) command 

e PDISPLAY (D) command 
e PRELEASE (R) command. 


Any of these commands must be submitted in the 88-byte buffer addressed 
by the PBUF= parameter and invoked by the request type REQ=COMMAND. 


The remaining operator commands are not available in the cross-partition 
communication environment. 


RETURN CODES FROM PUTSPOOL, GETSPOOL, AND CTLSPOOL 


Figure 3-5 shows the return codes that are supplied following the 
execution of a PUTSPOOL, GETSPOOL, or CTLSPOOL macro. These return 
codes are displayed in the SPER field of the SPL and in the error field 
of the DSECT generated by the TYPE=MAP operand of the SPL (at SPMXECBt4 
or ICRXECB+4), except for return codes X'41* and X'88*", which are 
indicated in XECBt4 only. 


XWAIT and XPOST return codes in register 15 are to be diagnosed by the 
user (See macro expansions: XPOST errors are doubled to maintain 
uniqueness). The XWAIT and XPOST macros and the corresponding return 
codes are described in the section "Cross-Partition Event Control 
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Get gS a ge ae pe eg Cae ee gp a a gee Fs eT ST Ce Rm ne ng fee en aye ee a Se ae ee OO ED 


jReturn|Meaning [Displayed at | 
jCode | |XECB*4 |SPER ] 
eet geek SR PURE Pac | 
{X*O8* End of data encountered during a GETSPOOL j x | X 1! 
| jrequest, or invalid LINENO specified in | { | 
| {GETSPOOL. } | | 
l | ! ! 
}X"°11" {Command not allowed. ! x | ».4 
{ | | | ! 
}X*%12* [Invalid POWER/VS output disposition in SPL. | x | X | 
i l ! ! | 
{X*?4* JInvalid output class (not A-Z) in SPL. ! x | x | 
| l | | | 
}X*18* |Invalid job name in SPL. ! x | x | 
| ! 1 { ! 
{X*217" |The PBUF buffer area is smaller than 88 bytes J] x | x t 
Jor not large enough to hold the largest output | j | 

Jdata record (PBUFL in GETSPOOL too small). | | ! 

| i 1 | 

X'22" |GETSPOOL was unable to locate output file by | x | Xx | 
|specified job name, job class, and dispatch- | { ! 

fable POWER/VS disposition, or requested output j | | 

|file is in use. | i | 

I | I I 

X*24* {A loop occurred in the PUTSPOOL buffer chain, | X | X | 
Jor more than 4096 buffers were used per | | | 
[request. | | | 

I ] | i 

X¥*28* {Invalid CTLSPOOL REQ operand. | x I x | 
! l ! ! 

X*4U4" |POWER/VS terminated normally, or | x i xX | 
{POWER/SVS terminated abnormally, or } Xx | t 
{|POWER/VS spool management task terminated | x | | 
fabnormally. ! | | 

{ | | 1 

X*4G2* {A POWER/VS error occurred during CTLSPOOL 1 x ¢ r 
} (see notes below). I } | 

| | | { 

X*44* JA POWER/VS error occurred during GETSPOOL (see | Xx | xX | 
Jnotes below). ij | } 

I | | l 

X¥*48* JA POWER/VS error occurred during PUTSPOOL (see | xX 1 xX | 
Jnotes below). | | | 

| | | | 

|X*82* jInvalid data buffer chain (PUTSPOOL). | X I X | 
| t | { | 
|X*84* JInvalid POWER/VS buffer address (PBUF). ' xX | Xx | 
J i | | l 
|X*88* |Invalid SPL address. } x | i} 
I 

I 


! 

{71. The first 44 characters of the POWER/VS message text are displayed] 
j in PBUF, starting at offset 28 of PBOUF. | 
|2. No spool management error detection is done for a CTLSPOOL request | 
| with REQ=COMMAND specified. You must analyze the message returned] 
| by POWER/VS in the PBUF area. If the command in the CTLSPOOL | 
! request results in more than one message, only the first message | 
| is returned. | 
{3. All values specified in the NEWVAL operand of the CTLSPOOL macro jf 
| must conform with the current POWER/VS values for priority, dis- |] 
I position, and related parameters. { 
a eg a gl ce 


Figure 3-5. PUTSPOOL, GETSPOOL, and CTLSPOOL Return Codes 
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| Job Accounting 


A single source program macro is provided for use in conjunction with 
POWER/VS: the PUTACCT macro. This macro relates to job accounting. 


When using POWER/VS, the job accounting interface information and 
POWER/SVS job accounting information is collected in the POWER/VS account 
file. The account file consists of five types of records: 


e Reader account records 

e List account records 

* Punch account records 

e Execution account records 


e BSC line and SNA session account records. 


The layouts of the account records are shown in Figures 3-6 to 3-11. On 
the account file, and after saving from the account file onto tape or 
disk, the records are included as physical sequential records. When 
saved on punched cards, account data for the reader, list, punch, and 
execution account records will appear in columns 2-72, and for the RJE 
account records in columns 2757. 


Column 1 of every card contains a copy of the record identifier (byte 
42) of the record, columns 73-78 contain the sequential account record 
number and columns 79-80 contain the sequence number within that record. 


READER ACCOUNT RECORD 


A reader account record is created for each read queue entry that is 
entered into the POWER/VS system. Whether or not the queue entry has 
actually been placed in the queue file is indicated by the POWER/VS 
cancel code. The record is copied from the first 58 bytes of the 
corresponding queue record. 
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Eee Se See ee wee ee ee ee ew ewe ee wee we wes ewww ee we we ewe ee ee ee ee eee eS eee we ee ee ee we es ee = 


for alphameric 
for binary 
for packed decimal. 


N The TO remote ID is a dummy entry in the Reader Account Record 
and in the Execution Account Record. It is copied from a FROM 
remote ID. 


Q 
+r tO e 
oo ae 6e 


[Bytes |Description {Pormat? | 
src se agen ea ee aR Na nl oN gaat | 
[00-07 [Date in format specified at SYSGEN (mm/dd/yy or | a | 
Ti ila od 
[08-11 [Start time of read, in packed decimal (OHHMMSSF; | p | 
| IF = sign). I | 
1 ! ! ! 
{12-15 {Stop time of read (OHHMMSSF; F = sign). | Pp 1 
! | 1 ! 
[16-31 [16 bytes of user information. | a ! 
| | | 

[32-39 {POWER/VS job name. ! a I 
{ ! | | 
}40-41 |Job number assigned by POWER/VS. I b ! 
| ! ! 
142 {Record identifier. { a | 
| | | I 
{43 [POWER/VS cancel code. { b | 
| | | | 
}44 |Reserved. ] b I 
| t | ! 
[45-47 |Reader device address, or SNA. I a | 
| | I ! 
{48 |FROM remote ID. | b Y 
i I | [ 
149 {TO remote ID. l b { 
| ! I I 
[50 [Input class. t a | 
I | ! l 
{51 {Input priority number. | a | 
! i ! t 
152-55 {Number of records read (including record added or | b Hy 
| [deleted by an RDR exit routine). } ! 
| 1 | 
[56-57 |Number of tracks for input storage. t ob ! 
I | 
1 

I 

I 

} 

| 

! 

{ 


Figure 3-6. Reader Account Record 


LIST ACCOUNT RECORD 


A list account record is created for each list queue entry that is 
processed by a list task. It is a copy of the first 72 bytes of the 
corresponding queue record. 
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oO  ""-- _-_ ornare eae e_ =< 00 0 sy 


{separator cards, or extra copies. 


a ee oe ee ee a ee ee ee ee ge ee ae Oe ee ee ee ee ee ee ee es ee we i es eee ee 


{Bytes |Description | Format? | 
100-07 [Date in format specified at SYSGEN (me/da/yy or) a—| 
{ ldd/mm/yy) - | | 
aa eduet time of list, in packed decimal (OHHMMSSF; : D 
| |F = sign). 1 ! 
| ! | 1 
112-15 {Stop time of list (OHHMMSSF; FP = sign). ! p | 
{16-31 ae bytes of user information from * $$ JOB card. ! a 
raped ipawenrrs job name. a ! 
‘nei ade number assigned by POWER/VS. ! b 
7 eee identifier. a 
oe i powRBAys cancel code. ! b 
ve esachved: b 
Tore egies device address, or SNA. a 
‘0 aoe remote ID. b ! 
ve a remote ID. b 
3 oe output class. ! a 
i eesaced output priority number. ! a 
isoces neabee of lines printed. b ! 
Rapes a etieg of tracks for output storage.? b 
sé ee suffix number assigned by POWER/VS.* b 
3 eer of printed copies.? b 
epee metay forms identification. a 
eee lifgakiox of extra records printed due to PRESTART, b 
t JPSETUP, separator lines, or extra copies. | t 
ae gawhee of pages printed (skips to channel 1). b 
eee langues of extra pages printed due to PRESTART, PSETUP, b 
: = 

l 


[2 Only for spooling to disk. When spooling to tape, field is zero. 

|2 If more than one copy is provided, the statistics are totals for all] 
! copies. | 
{3 a: alphameric ! 
{ bs binary I 
| p: packed decimal. | 
| | 


* Will be X'FF*® for last or only segment of job. 
| eae a a ee a a a a | 


Figure 3-7. List Account Record 
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PUNCH ACCOUNT RECORD 


A punch account record is created for each punch queue entry that is 
processed by a punch task. It is a copy of the first 68 bytes of the 
corresponding queue record. 


a a a a a A a a a a | 


|Bytes |Description | Pormat3 
00-07 |Date in format specified at SYSGEN (mm/dd/yy or | a 
jdd/mm/yy) - t 
08-11 eaee time of punch, in packed decimal (OHHMMSSF; 2) 
|F = sign). | 
12-15 lees time of punch, (QHHMMSSF; F = sign). dD 
16-31 a bytes of user information from * $$ JOB card. a 
32-39 eee job name from * $$ JOB card. a 
4O-41 sek number assigned by POWER/VS. b 
42 stoma identifier. a 
43 Bowe aE cancel code. b 
44 eagaeoe b 
R5-47 eae device address, or SNA. a 
48 ae renote ID. b 
49 - remote ID. » 
50 eaeas output class. a 
51 {Punched output priority number. a 
§2-55 iadeeee of records punched. : b 
56-57 [Number of tracks for output storage.? b 
58 nee suffix number assigned by POWER/VS.* b 
59 aaanee of punched copies.? b 
60-63 ieaaer forms identification. a 
64-67 {Number of additional cards punched due to restart, | a 


|separator cards, or extra copies. 


1 Only for spooling to disk. When spooling to tape, field is zero. 

2 If more than one copy is provided, the statistics are totals for all 
copies. 

3 a: alphameric 
b: binary 
p: packed decimal, 

* Will be X'FF*® for last or only segment of job. 


Ca tar re PS Sesser erunramemessvanansnamsall 


Figure 3-8. Punch Account Record 
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EXECUTION ACCOUNT RECORD 


An execution account record is created for each queue set (user ‘job 
step) that has been processed by POWER/VS. 


{Bytes {Label 


| mn a we wr we i we we i i we we ww wn on we ew ee ee ew we 


112-115 [= 
116-119 = 


120-123 


124-127 


128- 


O 
n 
\ 
Le) 
~J 
t 


ee ee ee ee ee ee em a ee re ee ge ee ee ee ee ee a ee ee ee ee i ee Oe ew wee ee Sew eee 


J}? POWER/VS will update the SIO tables in the execution account record 


|Description 


{Date in format specified at SYSGEN 

| (mm/dd/yy or dd/mm/yy). 

jStart time of job (OHHMMSSF; F = sign). 
{Stop time of job (QHHMMSSF; F = sign). 

116 bytes of user information. 

|Current POWER/VS job name. 

|Job number assigned by POWER/VS. 

|Record identifier. 

{POWER/VS cancel code. 

|Reserved. 

|Reserved. 

{FROM remote ID. 

|TO remote ID. 

jClass. 

{Priority. 

[Number of lines spooled. 

|Number of cards spooled. 

|Number of pages spooled. 

[Length of SIO table. 

JLength of total account record. 

|Reserved. 

[DOS/VS job name from // JOB card. 

{16 bytes user information from // JOB card. 
[Partition ID in EBCDIC format. 

{[DOS/VS cancel code. 

jType of record; S =job step, L =last step. 
jReserved. 

|Phase name, taken from // EXEC card. 

jEnd addr. of active program phase, COMREG. 
{CPU time elapsed in a job step; counted in 
{300ths of a second. 

{Overhead time; elapsed time not charged to 
Jany partition, in 300ths of a second. 
{All-bound time; system wait state time 
{divided between running partitions, in 
}300ths of a second. 

|SIO tables: 6 bytes for each device speci-~ 
jfied by SYSGEN options, as follows: 

[two bytes for device address (Ocuu), 


| Format? | 


er i a Re es eet A A he ee 


!four bytes for count of SIOs in current job| 


jstep.? 


}Overflow byte: normally X*20*, but X*30* if] 


Jmore devices are used within a partition 
[than specified by SYSGEN options. 


|User account information (provided via user| 


|PUTACCT macro). 


a 


yvsorrrrvIAa rv yoarpAuY 


eon ea A 


sr F oP 


| with the number of I/Os it has intercepted for spooling purposes. 
{2 a: aliphameric, b: binary, p: packed decimal. 

! (7) m = Total length of SIO tables. 

1 (*) Maxinum length of execution account record = 2008 bytes. 
a er PS se CS | 


Figure 3-9. Execution Account Record 
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RJE ACCOUNT RECORDS 


A line account record is created for each RJE,BSC user session when 


signoff or line stop is processed. 


of the 


Line Control Block. 


It is a copy of the first 56 bytes 


Ce ee ey en ae ees oe 
| Format! } 


|Bytes 


re ce ee ee we ee ee ee ee re ee es ee ee ee we ee we we we we ee ee ee ee ee ee we we a ee es ae ee 


{Date in format specified at SYSGEN (mm/dd/yy 


100-07 
| 


| 
108-11 
j 
} 12-15 


| 
116-31 


fF . fF « 
20 © WNW £ 
1 
& 
~J 


(Sa) 
oO 
! 
Ww 
— 


[Description 


jor dd/mm/yy) . 


| 
|SIGNON time in packed decinal 


{(OMMMMSSP; F 


! 
|SIGNOFF time (OMMMMSSF; F = sign). 


116 bytes user information. 
i 


}Line password. 


|Number of invalid responses during transmission (4). 


I 

{Record identifier. 

| 

[SIGNOFF code 

{X*01* - Normal SIGNOFF 


}X*0O2* - SIGNOFF forced due to central stop 


}X*O4* - SIGNOFF forced due to excessive idle time 
{xX*08*" - SIGNOFF forced due to unrecoverable I/O error. 


|Terminal error count. 

on address. 

ae remote ID. 

ia remote ID. 

iiewrcetestien count per session 
evade count per session (2). 


[Error count per session (3). 


alphameric 
binary 
packed decimal. 


(1). 


He) 


yr 
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| a a | 


Figure 3-10. 


RJE,BSC Line Account Record 


Comparing (1) to (2) gives an indication of idle time per session. 


Comparing (1), (3), and (4) gives an indication of line quality. 


(2), and (3) are also printed locally at SIGNOFF. 


terminated. 


Chapter 3. 


‘A session account record is created when an RJE,SNA user session is 
It is a copy of bytes 32-79 of the SNA unit control block. 


Using POWER/VS 


(1), 
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{Format? | 


[Bytes 


ee ee ee ee ee Oe ie Oe ee ee ee ee ee a ee ee ee ee eee wwe BO wee we we eee eee 


Figure 


|Description 


[Date in format specified at SYSGEN 
[dd/mm/yy) - 

ere time (OHHMMSSF; F = sign). 
ieceuaee time (OHHMMSSF; FP = sign). 
tae bytes of user information. 
iaaacad unit name. 


{Number of invalid responses during transmission. 


ISNA record identifier. 

! 

!Session termination code 

1X*O1* - normal termination (LOGOFF 
1X*02* - abnormal termination. 


JRemote identifier. 


alphameric 
binary 
packed decimal. 


{mm/dd/yy or 


or SIGNOFF) 


3-11. RJE,SNA Session Account Record 
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PUTACCT MACRO 


The PUTACCT macro adds user account information to the end of the 
execution account record. The macro is included in the user-~written 
S$JOBACCT phase that is called at the end of each job or job step. 


The exact location of the field for the user account information can 
vary, and is dependent on the length of the SIO tables field that 
directly precedes it. 


SSS Sn re 
|Name |Operation {Operands {Coil | 
! ! | 172 
|{ name }|PUTACCT | (cteg1) , (reg2) ! 1 


Nc eur ir ms ep ch a Src ris ee a te ns ceo 


Programming Notes: 


(reg tT) must specify the address of the area containing the user 
account information. Register notation must be used. 
Any general register except registers 0, 1, 14, and 15 
may be specified. 


(reg2) must contain the length of the area. Register notation 
must be used. Any general register except registers 0, 
1, 148, and 15 may be specified. The maximum length may 
not exceed 2008 bytes minus 8 bytes for the control field 
Minus the length of the execution account record. 


Note: If POWER/VS does not support job accounting or if 
the partition is not running under control of POWER/VS, 
the POTACCT macro is ignored. 


In the following, an example routine is shown to insert user information 
in the POWER/VS execution account records: 


COMRG GET PARTITION COMMUNICATION REGION 
USING CMRG,R1 DECLARE ADDRESSABILITY 
POWFLG1,X'80* | ACCOUNT SUPPORT FOR THIS PARTITION 
EXIT BRANCH IF NOT 
R4,ADAC ADDRESS ADDITIONAL INFO 
RO,L*ADAC LENGTH ADDITIONAL INFO 
PUTACCT (R1), (RO) PASS INFO TO POWER/VS 
DS OH 
BR RE RETURN TO $JOBCTLN 


DC C* ADDITIONAL ACCOUNT INFORMATION! 
EQU 1 REGISTER 1 

EQU 0 REGISTER 0 

EQU 14 REGISTER 14 


CMRG DSECT 

DS CL 164 
POWFLG1 EQU * 

END 
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| Output Segmentation 
SEGMENT MACRO 


The SEGMENT macro allows control of output segmentation and the 
specification of new output parameters to POWER/VS for a job running in 
a POWER/VS-controlled partition. 


jName |Operation [Operands {Col} 
] | 172 ! 
|{ name J| SEGMENT } DEVADDR=SYSxxx CO *}1 
| | | 1 
t | I{ ,FORMS=yyyy J eee 
| | f 

| l pa J 10 *I1 
| | | (reg) 1 | 
! { | ! | 
| ! I{ -NAME=naBpe ] l l 


a ce ae a Le EE | 


Programming Notes: 


DEVADDR= specifies the system or programmer logical unit assigned 
to the device on which the segmentation is to occur. 
This may be SYSLST, SYSPCH, or SYS000 - SYSmax. This 
operand is required. 


FORMS= specifies the new 1- to 4-character forms identification 
to be supplied to POWER/VS. The forms identification 
Must be alphameric, a slash (/), a hypen (-), or a period 
(.-). If this operand (as well as the JECL operand) is 
omitted, the forms identification will be blank. 


JECL= specifies, in place of the forms identification, the 
address of a 71-byte save area in which a POWER/VS 
* $$ LST, PUN or JOB statement is stored. The LST or PUN 
parameters of the * $$ LST or PUN statements need only be 
coded if the default values are not sufficient. For 
details, refer to "POWER/VS Job Entry Control Language 
Statements" in this chapter. No continuation statements 
are allowed. Any valid POWER/VS parameters may be placed 
in this JECL area. This operand may be specified as a 
symbolic address or in register notation (registers 
2-12). 


NAME= specifies a 1- to 8-character name which will be given to 
the new segment. If this operand is omitted, the name of 
the segment active on the task will be used. 


Note: If JECL JOB statements are to be passed via the JECL operand, the 
NAME operand should be omitted. The SEGMENT macro causes segmentation 
to occur and establishes new values for a new segment. If a JECL JOB 
statement is passed, it will rename the current segment and should be 
passed after a JECL LST or PUN statement is passed. JECL JOB statements 
should only be used to provide new user information. 


If the output device is not being spooled by POWER/VS, a message will be 
issued on SYSLOG so that the operator can take the reguired action. 
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If output segmentation is requested for output directed to a 3800 
printer, be aware that POWER/VS uses the default printer setup for the 
new segment unless you have supplied a JECL LST (or PRT) statement 
defining the same printer setup. After issuing the SEGMENT macro you 
can also issue in your application program a SETPRT macro requesting the 
proper printer setup. 


Example of SEGMENT macro use: 


LA R2,LSTCARD 
SEGMENT DEVADDR=SYSLST,JECL= (RZ), 
NAME=TESTOUT 


LSTCARD DC CL71** $$ LSP FNO=ACB,DISP=H,PRI=1!° 


RETURN CODES 


Successful completion of the SEGMENT macro is indicated to the problem 
program by a return code of 0 in register 15. If the operation fails, 
register 15 contains one of the return codes listed below. 


Return Code Meaning 
Dec} Hex 


One of the following; 


The device addressed by the DEVADDR operand is not a 
device currently being spooled by POWER/VS. 


POWER/VS is not active. 


The partition in which your program is running is not 
supported by POWER/VS. 


The spooled device has a disposition of N. 


The JECL statement provided was not a * $$ JOB, LST, 
or PUN statement. 


POWER/VS cannot accept the JECL statement because the 
partition was not started as a multitasking partition and 
the partition is waiting for work, or the partition was 
started as a multitasking partition and is waiting for 
work, but no JECL statement was submitted for this 
device. 
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POWER/VS AUTOSTART Statements 


POWER/VS offers an automatic start-up facility, called AUTOSTART, that 
facilitates the POWER/VS initiation, especially when POWER/VS must be 
terminated and restarted frequently and with identical spooling device 
assignments. 


The following four control statements are available to automatically 
initiate POWER/VS: 


The FORMAT statement 
The READER statement 
The PRINTERS statement 
The PUNCHES statement. 


@#ese 


These statements, which may be entered from a diskette file, via a 
cataloged procedure, or in cards, and which must be submitted to the 
system via the SYSIN device assigned to the POWER/VS partition, are 
described in the following sections. 


If an error is detected in an AUTOSTART statement (card deck, diskette 

file, or cataloged procedure), POWER/VS expects the corrected statement 
and all subsequent start-up statements to be entered from the console. 

The remaining statements in the card deck, the diskette file, or in the 
cataloged procedure are ignored. 


Note: The POWER/VS AUTOSTART statements start always in card column 1. 


STATEMENT DESCRIPTIONS 
FORMAT Statement 


By means of the FORMAT statement, you specify whether you want to 
perform a warm start, or, if not, which of the POWER/VS files are to be 
formatted. You use this statement, which must immediately follow the 
// EXEC POWER job control statement, in a way similar to the response 
_you would provide for message 1011D if POWER/VS AUTOSTART were not 
available. 


ee a SOE CSNY A aT 
| NO | 
| Q } 
| FORMAT=<D l 
! A | 
| conbination ! 
, | 


No indicates that no POWER/VS file is to be formatted. This 
is a POWER/VS warm start. 

Q indicates that the POWER/VS queue file is to be 
formatted. 

D indicates that the POWER/VS queue and data files are to 
be formatted. 

A indicates that the POWER/VS account file is to be 
formatted. 
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combination indicates that two of the parameters 0, D, and A may he 
specified. The parameters can be specified in any 
sequence; they must be separated by commas. For example, 
to indicate that all three files are to be formatted, 
specify PORMAT=A,D. 


One blank must follow the parameter (or the parameter sequence) 


specified in this statement. Only one FORMAT statement may be issued 
for the POWER/VS AUTOSTART procedure. 


EADER Statement 


Using the READER statement, you define the input spooling device of the 
POWER/VS-controlled partition identified in the immediately preceding 
PSTART command. The value to be specified for this statement is similar 
to the response you would provide for message 1R50D if POWER/VS 
AUTOSTART were not available. 


Fir se ee ge gE a eS ee eee Ga eee a ge a ee eee 
| READER=fNO | 
| c uu | 
Se Cee Ee a ee | 


NO indicates that no input spooling device is to be assigned 
for this partition. Por POWER/VS, this means that the 
partition being started is a writer-only partition. 


cuu specifies the channel and unit address of the partition's 
input spooling device. Only one input spooling device 
may be specified per partition; however, you may specify 
the same device for several partitions. 


I EE TS 


By means of the PRINTERS statement, you define the list (print) output 
spooling devices of the POWER/VS-controlled partition identified in the 
preceding PSTART command. The value to be specified for this statement 
is similar to the response you would provide for message 1R50D if 
POWER/VS AUTOSTART were not available. 


re ey eS a a i eS ee ee 
| PRINTERS={NO | 
| cuut,...,cuus 
[er a | 


No indicates that no list {print) output spooling device is 
to be assigned for this partition. If PRINTERS=NO and 
PUNCHES=NO (see below) is specified, this means that the 
partition being started is a reader-only partition. 


cuus specifies the channel and unit addresses of up to eight 
list (print) output spooling devices in this partition. 
If more than one device is to be specified, any two "cuu" 
definitions must be separated by a comma. The same 
device or devices may be specified in several partitions. 
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PUNCHES Statement 


Using the PUNCHES statement, you define the punch output spooling 
devices of the POWER/VS-controlled partition identified in the preceding 


PSTART command. 


The value to be specified for this statement is similar 


to the response you would provide for message 1R50D if POWER/VS 
AUTOSTART were not available. 


Geta ae ees tg yee fe ee Se eee Sa eee ee ep aoe ae ee | ATE Cree “f ge™. ee Ct oe ge gO 


| PUNCHES= 


! 
poidiaeschaey t 


a ce a A Ne ea En ETT | 


NO 


indicates that no punch output spooling device is to be 
assigned for this partition. If PUNCHES=NO and 
PRINTERS=NO (see above) is specified, this means that the 
partition being started is a reader~only partition. 


specifies the channel and unit addresses of up to eight 
punch output spooling devices in this partition. If more 
than one device is to be specified, any two "cuu" 
definitions must be separated by a comma. The same 
device or devices may be specified in several partitions. 


An example of how to use the POWER/VS AUTOSTART statements is contained 
in "Initiating POWER/VS with AUTOSTART" in Chapter 4 of this manual. 
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Chapter 4. Operating a System. 
Controlled by POWER/VS 


There are two ways of submitting jobs to POWER/VS and of retrieving 
them: 


¢ By starting the POWER/VS partition explicitly as in the procedure 
described below. 


* By using the PUTSPOOL macro as described in Chapter 3. 
The POWER/VS cross-partition facility requires no commands (for example, 


PSTART or PSTOP)}) to be given. Spool management tasks are created and 
deleted dynamically by POWER/VS. 


Assumptions 


The following sample procedure for initiating POWER/VS and running jobs 
under the control of POWER/VS is based on the assumption that POWER/VS 
resides in partition F1 and that the following I/0 devices are available 
for spooling input and output: 

IBM 2540 Card Reader with device address Xx*00C* 

IBM 2540 Card Punch with device address X*00D° 

IBM 1403 Printer with device address X'00R* 

IBM 3203 Printer with device address X*OQ1E® 

IBM 3800 Printer with device address X'118* 

IBM 3340 Direct Access Storage with device address X*260° 

IBM 3330 Disk Storage with device address X*'133* 

IBM 2780 Data Transmission Terminal with device address X*'060°. 

The direct access storage is used for the POWER/VS files; the data 


transmission terminal for remote job entry. The example also assumes 
that POWER/VS will support BG, F2, and F3. 


Initiating POWER/VS 


POWER/VS can be initiated at any time. POWER/VS is initiated in a 
DOS/VS system like any problem program. In addition, the AUTOSTART 
facility is available, which allows you to start POWER/VS with a mininum 
of intervention. The facility is particularly useful if POWER/VS must 
be initiated frequently with unchanged device addresses, tasks, spooled 
partitions, and RJE lines. For details concerning the POWER /VS 
AUTOSTART facility, consult the section "POWER/VS AUTOSTART Statements" 
in Chapter 3. 


The start-up procedure (with and without AUTOSTART) includes the 
following steps: 
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e Formatting of POWER/VS queues. (Not necessary when the information 
already accumulated is to be used. This procedure is called a warn 
start.) If the extents used to define the POWER/VS files are changed 
between one execution of POWER/VS and another, the POWER/VS files 
should be reformatted. These files should also be reformatted if a 
new generation of POWER/WVS was link-edited since the files were used 
last. 


e Verifying that the disk packs used for the POWER/VS files are mounted 
on the proper disk drives and that these drives have been made ready. 


* Starting POSER/VS tasks. 
® Starting POWER/VS controlled partitions. 


¢ Specifying the devices to be spooled in each controlled partition. 


INITIATING POWFR/VS WITHOUT AUTOSTART 


The following is a description of the steps required to start POWER/VS 
when the AUTOSTART facility cannot be used: 


a 


Make the reader, the printer, and the punch available for POWER/VS use 
by unassigning these devices in the partition that owns them; for 
example: 


ASSGN SYSIN,UA 

ASSGN SYSLST,UA 

ASSGN SYSPCH,DA 

ASSGN SYSnnn,UA (if the device was used as a programmer logical 
unit). 


You may also enter the sequence 


DVCDN X*cuut 
DV¥CcUP X'cuut 


for each of the affected devices. 
If the partition into which POWER/VS is to be loaded is still active, 
stop it by issuing the STOP coamand. 


Step_2 


Allocate sufficient real and virtual storage to the POWER/VS partition. 
If the supervisor of your system was generated with the required real 
and virtual storage allocations, this step may be omitted. Your system 
programmer will tell you how such storage you must allocate. A typical 
example: 


ALLOCR FTR=30K 
ALLOC FP1=196K 
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Note: Before you can allocate the required real and virtual storage 
space for the POWER/VS partition, you must stop all partitions in your 
DOS/VS system by means of the DOS/VS command UNBATCH partition. After 
successful storage allocation, you may start the DOS/VS partitions 
again. 


Step 3 


Start the POWER/VS partition using the START command. For exanple, 
enter: 


START F1 


Step_4 


You can omit this step if you intend to enter the POWER/VS initiation 
statements via SYSLOG (see step 6). Otherwise, assign SYSRDR to the 
device from which the POWER/VS initiation statements are to be read. 


Step_5 


Assign SYSLST if your installation requires 
e A status report after a warm start. 


°e A dump of the POWER/VS partition, should POWER/VS terminate 
abnormally during initiation. 


See Figure 4-2 for an example of a status report after a warm start. 


Step 6 


Place the POWER/VS initiation statements into SYSRDR assigned in step 4. 
An example of these statements, which vary from one installation to 
another, is given in Figure 4-1. 


JOB POWER/VS INITIATION 

ASSGN SYS000,X*2608 

DLBL IJAFILE,*POWER/VS ACCTPILE',99/365,DA 
EXTENT SYS000,POWER1,1,0, 12,60 

ASSGN SY¥S001,X*2605 

DLBL IJQFILE,'QFILE POWER/VS!,99/365,DA 
EXTENT S¥YS001,POWER1,1,0,72,48 


ASSGN SYS002,X'133% 

ASSGN SYS003,X*134* 

DLBL IJDFILE,*DATAFIL POWER/VS*,99/365,DA 
EXTENT SYS002,POWER1,1,0,95,855 

EXTENT SYS003,POWER2,1,0, 3800, 1045 

EXEC POWER (see note 3 below) 


Figure 4-1. Job Stream Example for POWER/VS Initiation 
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- DLBL and EXTENT statements may have been stored on the label 
cylinder (s}) of your system pack. In this case, they need not be 
provided as part of the initiation job stream. 


Notes: 
1 


2. S¥SO000, S¥S001, and SYS002 may be assigned to different device 
types. 


3. If your POWER/VS system includes RJE,SNA support, or if you are 
using an IBM 3800 printer, you must specify the SIZE= parameter in 
the // EXEC statement; for example: 

// EXEC POWER,SIZE=234K. 


POWER/VS STATUS REPORT 04/30/77 


TOTAL NUMBER OF QUEUE RECORDS RECORDS 
NUMBER OF FREE QUEUE RECORDS RECORDS 
MAX. NO. OF QUEUE RECORDS USED IN PRESENT SESSION RECORDS 


DATA FILE IJDFILE 


TOTAL NUMBER OF TRACKS TRACKS 
TRACK GROUP SIZE TRACK 
DATA BLOCK SIZE BYTES 


ACCOUNT FILE IJAFILE 


TOTAL NUMBER OF TRACKS TRACKS 
PERCENTAGE OF PILE THAT IS FILLED 


REAL STORAGE ALLOCATED TO POWER/SVS PARTITION 

NUMBER OF TIMES WAITING FOR REAL STORAGE 

MAXIMUM NUMBER OF REAL PAGES FIXED 

MAXIMUM NUMBER OF TASKS ACTIVE AT ONE POINT IN TIME 


Figure 4-2. Example of a POWER/VS Status Report 


otes: 
- $If POWER/VS has been generated without the job accounting support, 
the account file statistics are replaced by the message 


NO ACCOUNT SUPPORT. 


2. Statistics provided by POWER/VS following a warm start supply 
information about activities from the time POWER/VS was started 
until the time the statistics are displayed. The maximum number of 
queue records used in a report after warm start gives the number of 
active entries. 


3. Statistics provided by POWER/VS following a PEND command give 
information about the ended POWER/VS session. 


Up to five extents can be specified if additional extents are needed for 
the POWER/VS data file. They can be either on the same volume, or if 
they are on different volumes, logical unit assignments must be in 
ascending sequence of volumes to be used. SYS002-SYS006 can be used for 
the POWER/VS data file; they must be assigned to the same type of 
device, 
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Step 7 


When the message 
101711D FORMAT QUEUES= 


is displayed, your response can be one of the following: 


OP ,AJy = Format the queue file {and, optionally, the account file}. 

DD,A} = Format the queue file and the data files [and, optionally, 
the account file]. 

A = Format the account file. 

NO = No formatting is reguired (warm start). 


Note: Instead of entering NO, you may simply press END/ENTER. 


If you perform a warm start, and if you assigned SYSLST in step 5, 
POWER/VS prints a status report (see Figure 4-2 for an example). 


In case of an abnormal warm start (warm start after an abnormal termi- 
nation of POWER/VS), the following job number will be one higher than 
expected to prevent duplicate job numbers for accounting information. 
When initiation is complete, the message 


JQO12T POWER/VS INITIATION COMPLETED 


is displayed. SYSRDR, SYSIPT, SYSLST, and SYSPCH are then unassigned in 
the POWER/VS partition. 


Step 8 


Use the PSTART command to start POWER/VS tasks. For example, the 
statement: 


PSTART RDR,OOC,A 


causes a POWER/VS reader task to spool input from 00C and assign class A 
to all reader queue entries from that reader, unless another class is 
specified in the JECL for an entry. 


The statement: 
PSTART F2,2A 


places a partition under control of POWER/VS. Note that, for this 
purpose, F2 must have lower priority than the POWER/VS partition. How 
to start POWER/VS tasks, partitions and RJE lines that are to operate 
under control of POWER/VS, is described in more detail later in this 
procedure. 


When you enter the PSTART command to bring a partition under control of 
POWER/VS, you are prompted to specify the devices that are to be spooled 
for that partition. The prompting messages are (for the above example): 


PLEASE SPECIFY DEVICES TO BE SPOOLED 
F2 READER= 


F2 PRINTERS= 
F2 PUNCHES= 
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SYSLOG stops after each message to allow you to specify a device address 
(or NO if a specific device type is not used) as shown in the example 
below: 


READER=00C 
PRINTERS=00E,01E 


POUNCHES=NO 


Note: If your response is READER=NO, but you specify one or nore 
addresses for PRINTERS or for PUNCHES or for both, POWER/VS operates as 
a writer-only spooling program for the partition concerned. POWER/VS 
spools the input only if your response is READER=cuu, PRINTERS=NO and 
PUNCHES=NO. A device can be specified only once, even if it can both 
read and write. 


Step 9 


After a partition has been brought under control of POWER/VS, I/0 
requests from that partition to the specified devices are intercepted by 
POWER/VS. If the reader queue does not contain an entry for processing 
in this particular partition, POWER/VS displays the message: 


1Q034I F2 WAITING FOR WORK 


INITIATING POWER/VS WITH AUTOSTART 


The following are examples for the steps required to start POWER/VS 
using the AUTOSTART facility: 


Step 1 


Start the POWER/VS partition, using the START command. You may have to 
stop the partition before you can issue the START command. 


Note: The initiation statements, and also the AUTOSTART cards, may be 
supplied via a SYSIN file on disk, tape, or diskette, or via a card 
reader, but the // EXEC POWER statement should not be supplied via a 
procedure. If this is done, the DOS/VS procedure library is in use 
during the entire POWER/VS run and may not be updated until POWER/VS is 
ended. 


Step _ 2 


Assign SYSIN for the POWER/VS partition to the device from which the 
POWER/VS initiation statements and the POWER/VS AUTOSTART statements are 
to be read. 


Step 3 


Place the required statements in the SYSIN device assigned in step 2 and 
make the device ready. You may also supply the initiation and AUTOSTART 
statements via a cataloged procedure. An example of the AUTOSTART 
statements that may be presented to POWER/VS immediately following the 
// EXEC POWER statement is given below: 
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FORMAT=NO 
PSTART RDR,OOC 
PSTART BG,ABC 
READER=00C 
PRINTERS=00E 
PUNCHES=00D 
PSTART F2,DEF 
READER=00C 


PRINTERS=01E 
PUNCHES=00D 
PSTART LST,OOE 
PSTART LST,O1E 
PSTART PUN,OOD 
PSTART RJE,060 
/* 


The FORMAT statement must be the first one after the // EXEC statement. 

If the FORMAT statement is omitted, POWER/VS prompts you for acceptable 

format specifications in the same way as it does when you start POWER/VS 
without AUTOSTART. 


The statements that start a system task (partition) can be entered in 
any sequence. However, once a partition has been started, the device 
specifications for that partition must follow immediately and in the 
sequence: 


1. READER= statement 
2. PRINTERS= statenent 
3. PUNCHES= statement. 


After POWER/VS has processed the FORMAT statement and read the remaining 
statements from SYSIPT, it uwnassigns SYSRDR, SYSIPT, SYSPCH, and SYSLST 
for the POWER/VS-controlled partitions and processes the PSTART commands 
that were submitted via SYSIPT. If any of the PSTART commands are 
invalid, POWER/VS prompts you to specify the correct device address. 


Job streams to be processed under control of POWER/VS can immediately 
follow the POWER/VS AUTOSTART statements. 


Spooling device specifications can be made as follows: 


READER=JNO 
cuu 
ice fe 
cuut,cuu2,...,cuus 


PUNCHES=jJNO 
cuut,cuu2,...,cuus 


If the spooling device specifications in the AUTOSTART statements are 
incorrect or incomplete, POWER/VS prompts you for acceptable 
specifications in the same way as it does when you start POWER/VS 
without AUTOSTART. 


ASSIGNING DUMMY DEVICES 


POWER/VS intercepts I/O requests addressed to specific physical devices, 
regardless of the symbolic units that are assigned to these physical 
devices. If 1/0 requests are intercepted by POWER/VS, the assignment 
for the physical unit is in fact a dummy assignment, because the 
physical device is not used by the problem program. With POWER/VS you 
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can assign logical units in different partitions to the same physical 
unit-record device. Such assignments are regarded as dummy assignments, 
since the assigned physical device is not used by all the partitions in 
which it is assigned. Dummy devices, however, are not required, except 
for multifunction card devices. The use of writer-only partitions as 
well as cardless systems normally require dummy devices. 


Each ASSGN statement or command in a POWER/VS-controlled partition is 
checked by job control to determine if I/0 requests for the specified 
logical unit are to be intercepted by POWER/VS. If requests for a 
certain physical unit are to be intercepted by POWER/VS, job control 
will not check for conflicting I/0 assignments. As a result two or more 
assignments are permitted from different partitions to the same unit- 
record device, as long as no more than one of these assignments implies 
physical ownership of the device. 


CHANGING PARTITION PRIORITIES 


The priority of the POWER/VS partition must always be higher than that 
of the partitions under its control. 


If you want to change the priorities of the partitions while POWER/VS is 
active, the DOS/VS PRTY command is rejected if you make an attempt to 
give one of the partitions supported by POWER/VS a higher priority than 
the POWER/VS partition. 


POWER/VS initialization is canceled if the priorities of the partitions 
conflict with the POWER/VS requirements. 


issuing POWER/VS Commands 


POWER/VS commands can be entered in one of three ways: 
e At the system console by the central operator 
* At a remote terminal or work station by the terminal operator 


°® Within an avplication program by means of the CTLSPOOL macro. 


At the system console, POWER/VS operator commands are entered in the 
same Way as attention routine commands (omit steps 1 and 2 if your 
system operates on a Model 115 or 1425): 


1. Press REQUEST 

2. Wait for AR to appear 
3. Bnter the command 

4. Press END or ENTER. 


Most of the POWER/VS commands available to the central operator are 
either queve management or task management commands. Queue management 
commands enable you to manipulate the queue entries for the POWER/VS 
jobs; task management commands allow you to control POWER/VS operation. 
Figure 4-3 shows the two groups of commands by the function they 
control. 
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IType_of |Command [Short |Function ! 
| Command {Code !Formn | | 
Le I ee eae me ee et oe fe aw ee eae eR ee at ae oe ate ee i 
} Queue | PDISPLAY |} oD {Display the status of POWER/VS | 
|Management | ! }job(s). | 
|Commands | | | 
| |} PALTER } A jAlter the processing attributes of | 
i | t ja POWER/VS job. | 
! | i | | 
| } PDELETE } .L |Delete gueve entries or messages. | 
| | | | | 
| | PRELEASE { Rk [Release POWER/VS jobs for further | 
| t H |processing. I 
[SaaS Se eee ee eae nee eee ee ee ee he eee ee ne ae 1 
| Task JPSTART } Ss {Start a task, place a partition un-| 
| Management l ] Jder the control of POWER/VS, or I 
| Commands } Jestablish the POWER/VS-VTAM inter- | 
] { 1 |face (RJE,SNA). ! 
! ! | 
i | PSTOP |} P |Stop a task, release a partition | 
| ! H jfrom POWER/VS control, terminate j 
! | | Jan SNA user Session, or terminate | 
| | | |RJE,SNA processing. | 
I | I 1 I 
| |} PGo { 6G {Reactivate a task or a partition. | 
| ! | { ! 
| {PEND | {Terminate POWER/VS. | 
| 1 ! I | 
| | PCANCEL ft Cc {Cancel a POWER/VS status report. { 
I | | I l 
| {PFLUSH } F |Flush (cancel processing of) the | 
| { ! }current queue entry. | 
! | | | ! 
| |PRESTART } T |Restart a writer task. | 


| ee a | 


Figure 4-3. POWER/VS Commands 


Whenever you enter a queue management command related to a set of queue 
entries for a particular POWER/VS job, make sure that your command 
correctly identifies the job by the name under which it was logged by 
POWER/VS and, possibly, also by the number that POWER/VS assigned to it. 
A number is required when two or more POWER/VS jobs have been entered 
under identical names. 


If you are in doubt about the correct identification of a POWER/VS job, 
enter a PDISPLAY command specifying either the queue and the job name or 
the queue and ALL before you enter the queue management command in 
question. The status report you receive provides you with a list of 
POWER/VS jobs currently logged in a specific queue, and under a specific 
Name if you specified a job name. 


For the terminal operator, a set of commands similar to the JECL 
commands is available for entry at a remote terminal or work station. 
These commands, which are referred to as the Remote Operator Command 
Language (ROCL), are described in the POWER/VS Work Station User's 
Guide, GC33-6049., 
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To invoke a POWER/VS service from an application program executing in a 
partition other than the POWER/VS partition, the macro instruction 
CTLSPOOL may be used with the parameter specification REQ=COMMAND. 
However, this macro allows only five commands to be issued. These are: 


The PALTER command 
The PCANCEL command 
The PDELETE command 
The PDISPLAY command 
The PRELEASE command. 


The use of this macro and the related additional macros is explained in 
detail in "Cross-Partition Communication Macros" in Chapter 3. 


STARTING AND STOPPING A USER PARTITION 


Bringing a Partition Under the Control of POWER/VS 


When you bring a partition under the control of POWER/VS, you activate 
the POWER/VS task that makes spooled input available for processing in 
the named partition. 


To bring a partition under the control of POWER/VS, use the PSTART 
command. 


For example, the statement: 
PSTART F2,AB2 


causes those POWER/VS jobs in the reader queue with a class 
specification of A, B, or 2 to be executed in partition F2. 


Note: A class specification of AB3 in the above command would have been 
flagged as invalid because the partition-dependent class 3 does not 
match the partition identifier specified in the command (F2). 

The statement: 

S BG,OA,X 

causes POWER/VS to place the BG partition under control of POWER/VS. 


Jobs of class '0' and *A*® may be processed by this partition. All print 
and punch output will have a default class of 'X'. 


Changing the Class Specification for a Partition 


When a partition is placed under POWER/VS control, one or more progran 
classes can be specified to ensure that only programs with one of these 
classes can be executed in that partition. If it is desirable to change 
this class specification, proceed as follows: 


1. Stop the partition (see "Stopping POWER/VS Tasks" in the section 
"Task Control" below). 


2. Start the partition again using a PSTART command that specifies the 
new program Classes to be handled by that partition. 
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A user may have special spooling requirements not supported by POWER /VS, 
for example when using the special punch features of the IBM 2560 
Multifunction Card Unit. This requires special handling for a Job. 

In the following, a procedure is described to stop a partition under 
POWER/VS, start it again under control of the DOS/VS supervisor, execute 
the job, and bring the partition back under POWER/VS control after the 
job is finished. 

e Stop the partition on a job boundary using PSTOP. 


e stop any POWER/VS reader or writer task that uses devices which say 
be required by the job to be run. 


e Issue the DOS/VS START command. 
¢ Assign the necessary devices for the partition. 
e Make the devices ready and start the partition using the ENTER key. 


e When the job has finished, stop the partition using the DOS/VS STOP 
command. 


e Issue the PSTART command to start the POWER/VS partition. 
TASK CONTROL 


Starting _a_ POWER/VS_ Reader Task 


A reader task reads records from a card reader, a tape, or a diskette 
device and writes them onto intermediate storage on disk. You may start 
a reader task any time you have a physical reader available, regardless 
of the number of reader tasks currently active. 


To start a reader task, use the PSTART command. For example, the 
statement: 


PSTART RDR,OOC,2 

starts a reader task with a partition-dependent class specification. 

The task causes the job streams in the specified reader (00C) to be read 
and spooled onto disk. Unless a different class is specified in the job 


streams, the POWER/VS jobs spooled by this task will be executed in 
partition F2. 


The statement: 
PSTART RDR,OOC,B 
starts a reader task with a partition-independent class. In this case, 


a POWER/VS job spooled by the task is assigned class B, unless a 
different class is specified in the job stream of that job. 
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The statement: 
PSTART RDR,OOB,, *INPUT®,2 


Starts a reader task to read a file named INPUT from two diskette 
volumes on device OOB. 


The statenent: 
PSTART RDR,480 


starts a reader task from a tape on device 480. 


Starting a POWER/VS Writer (List or Punch) Task 


A list (print) or punch writer task transfers data from intermediate 
storage to the printer or punch, respectively. You may start a list or 
punch task whenever you have a physical printer or punch available, 
regardless of the number of writer tasks currently active. 


To start a writer task, use the PSTART command. For example, the 
statement: 


PSTART LST,OOE,AB 

starts a list (print) task to print output of POWER/VS jobs that had 
classes A and B assigned. The task uses the printer whose device 
address is OOF. 

The statement: 

PSTART LST,1318,T,2 

starts a list {print) task with two print buffers to print output of 
POWER/VS jobs that have class T assigned. The task uses the printer 
whose device address is 118. 

The statement: 


PSTART PUN,OOD,X*285° 


starts a punch task to punch on the device 00D the output that was spooled 
onto a tape. That tape is mounted on the drive with the address X'285'. 


Stopping POWER/VS_ Tasks 
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The PSTOP command is available to stop a POWER/VS task, to take control 
of a partition away from POWER/VS, and to stop transmission of data via 
an RJE line. 


To stop a reader task, you should specify EOJ as the second operand. if 
you fail to do so, the reader task terminates input processing 
immediately, the queve entry which was being built by the task is not 
included in the reader queue, and the rest of the statements will not be 
read. Examples of PSTOP commands to stop a reader task are given below. 
The statement: 

PSTOP OOC 


causes the associated reader task to stop input processing immediately. 
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The statement: 
PSTOP OOC,EOJ 


causes the associated reader task to stop after it has (1) finished 
processing the current POWER/VS job and (2) placed the queue entry which 
was being built into the reader queue. 


To stop a list task, you can use the PSTOP command without a second 
operand, or with EOJ or RESTART specified as the second operand. For 
example, the statement: 


PSTOP OOE 


causes the associated list task to stop output processing immediately, 
but the current queue entry is not deleted from the output queue. When 
the task is started again (by issuing a PSTART command), processing of 
the output for that queue entry starts again with the first output 
record. 


The statement: 
PSTOP OOE,RESTART 


has the same immediate effect as the above example. However, when the 
task is started again (by PSTART), processing of the output for the 
queue entry starts with the record following the last one processed 
before the PSTOP comnand was issued, and when a 3800 printer was used, 
with the copy group index being processed when the PSTOP command was 
issued. For more information on copy grouping refer to the description 
of the * $$ LST statement in Chapter 3. 


The statement: 
PSTOP OOE,EOJ 


causes the associated list task to stop after it has finished printing 
the output for the current list queue entry. When the task is started 
again (by PSTART), it processes the output of the next entry in the list 
queue, 


POWER/VS acknowledges the PSTOP command by message 10331. 


The information provided above for stopping a list task also applies to 
stopping a punch task. Examples of PSTOP commands to stop a punch task 
follow: 


PSTOP 00D 
PSTOP O00D,RESTART 
PSTOP O0OD,EOJ 


POWER/VS acknowledges the command by message 10331. 


The following procedure is recommended for using the PSTOP command to 
stop RJE lines, except in cases where a line must be stopped without 
regard for whether it is currently in the processing or inactive state: 


1. Issue a PINQUIRE ALL command to determine the current status of your 
RJE lines. 


2. Issue a PSTOP command for a line which is inactive. Specify FOJ as 
the second operand in your PSTOP command, in case a remote entry was 
started between the time processing of your PINQUIRE command was 
completed and processing of your PSTOP command begins. 
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If, for example, you issue the command 
PSTOP 060 


then all read and write activities are stopped immediately. If the line 
was being used to transmit data from the terminal, input data is lost. 


If the line was being used to transmit data to the terminal, that output 
data is still in the output gueve. If you issue the command 


PSTOP 060,E0J 


then transmission of input or output is allowed to continue until the 
end of the current queue entry. 


POWER/VS acknowledges the command by message 1R02I1. 


To take control of a partition away from POWER/VS, you also use the 
PSTOP command. For example, assuming that partition F2 was originally 
placed under POWER/VS control by an appropriate PSTART command, then 


PSTOP F2 


causes program execution in partition F2 for a particular reader queue 
entry to be completed and the partition to be returned to DOS/VS 
control. 


After the partition is released by POWER/VS, SYSRDR and all assignments 
to spool devices for this partition are also released. 


POWER/VS acknowledges the command by message 1033I. After display of 
this message, the partition is available for processing under DOS/VS. 


To return the partition to POWER/VS control, you have to issue the 
DOS/VS STOP or UNBATCH comman?, followed by a PSTART command. 


REMOTE JOB ENTRY - BSC TERMINALS 


Starting an RJE,BSC Line 


By starting an RJE,BSC line, you actually start a POWER/VS RJE task. 
This task processes job streams from a terminal and creates reader queue 
entries (one per POWER/VS job transmitted from the terminal). On 
request from the terminal operator, an RJE print or punch task makes 
output available for transmission to the terminal. POWER/VS allows you 
to start up to 25 RJE,BSC lines for concurrent operation. 


To start an RJE,BSC line, use the PSTART command. Por example, the 
statement: 


PSTART RJE,060 
causes the line with the physical device address 060 to be started. 


When POWER/VS has finished executing this command, a terminal operator 
whose terminal is attached to this line can sign on. 
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The statement: 

PSTART RJE,060,RJESYS12 

causes the same POWER/VS action as the above example. However, the 
SIGNON command from a terminal operator whose terminal is attached to 
line 060 is accepted only when he specifies the password RJESYS12 in his 
SIGNON command. 

Note: If a password is specified in the PSTART command for an RJE,BSC 


line, this password overrides the password specified in the PLINE macro 
for this line. 


Controlling RJE,BSC Operations 


The following POWER/VS commands can be used to monitor and control 
RJE,BSC operations from the central installation: 


PSTART Start an RJE line (this is discussed above). 
PINQUIRE Display the status of one or all supported RJE lines. 


PDISPLAY Display the status of RJE-type queue entries. 


PALTER Change the destination of output for remotely entered 
POWER/VS jobs. 

PDELETE Delete ALLUSERS messages originated by the central operator. 

PBRDCST Send a message to an individual terminal user or to all 


terminal users. 


PSTOP Stop an RJE line. 


REMOTE JOB ENTRY - SNA TERMINALS 


Establishing the VTAM Interface for POWER/VS with RJE,SNA 


Before SNA terminal users can log on to POWER/VS, you must have 
established the interface between POWER/VS and VTAM, as VTAM handles all 
physical line management for SNA terminals, using Synchronous Data Link 
Control (SDLC). 


VTAM must run in a partition with a higher priority than POWER/VS. 
To establish the interface, use the PSTART command in:the format: 
PSTART RJE,SNA 


This command causes POWER/VS to activate the VTAM interface by opening 
the Application Control Block (ACB), after which logical units that have 
been identified to VTAM can log on. If the command is valid, the 
message 1VO4I RJE,SNA STARTED is displayed. If the command is invalid, 
an information-type message is displayed. Refer to DOS/VS POWER/VS 
Workstation User's Guide, GC33~6049 for possible causes. 
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The following POWER/VS commands can be used to monitor and control 
RJE,SNA operations from the central installation: 


PSTART Establish the VTAM interface. 


PINQUIRE Display the status of one logical unit, or display the 
logical unit names of all active logical units (status: 
PROCESSING and LOGGED ON), together with the remote-IDs of 
the users operating then. 


PDISPLAY Display the status of RJE (BSC and SNA)-type queue entries or 
list all ALLUSERS-type messages. 


PALTER Change the destination, class, disposition, or copy count of 
output for remotely entered POWER/VS jobs. 


PDELETE Delete one or more entries from the specified job queue; 
alternatively delete one specific ALLUSERS-type message or 
delete all ALLUSERS-type messages. 


PBRDCST Send a message to an individual terminal user or to all 
terminal users. 


PSTOP Terminate a specific user session or deactivate the VTAM 
interface and thereby all current user sessions. 


To stop a session identified by *luname', the following format applies: 
PSTOP RJE,SNA,lLunamef[ ,E0J J 


RJE,SNA Informs POWER/VS that the command applies to an SNA session 
or to all SNA processing. If no more parameters are 
specified, POWER/VS immediately deactivates the VTAM 
interface. 


lunane Causes POWER/VS to terminate only the session with the 
logical unit whose name is specified by this parameter. 


EOU All active input or output processing will be completed for 
current POWER/VS job entries. If this parameter is omitted, 
all processing is stopped immediately for the affected 
session. 


In case of emergency, the central operator may also terminate a session. 
To do this, he issues the VTAM command 

VARY NET, INACT,1I,1D=luname 

upon which VTAM will notify POWER/VS in the LOSTERM exit. POWER/VS 


handles this termination in a similar way as an unconditional LOGOFF 
request. 
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The following lists the possible central operator commands to terminate 
RJE,SNA operations and the actions taken by the system: 


HALT QUICK This VTAM command causes VTAM to notify POWER/VS that 
an emergency stop is required for all active SNA 
sessions. 

HALT This VTAM command causes VTAM to notify POWER/VS to 


begin an orderly termination of all sessions. The 
same action is taken as if a conditional LOGOFF 
terminal command had been requested for all sessions. 


PSTOP RJE,SNA,EOJ POWER/VS makes a conditional termination 


or PEND for all sessions. 
PSTOP RJE,SNA POWER/VS makes an unconditional LOGOFF for all 
or PEND KILL sessions. 


TERMINATING POWER/VS 


POWER/VS may be terminated normally, for example when programs that do 
not need a POWER/VS environment must be run, or in an emergency. 


Normal Termination 
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Before you terminate POWER/VS, inform any operators of remote terninals 
that the shutdown procedure is about to begin. Then enter PEND. For 
example, the statement: 


PEND 


causes {1) all active tasks to continue processing until they encounter 
the end of the current POWER/VS job, (2) the POWER/VS-controlled 
partition to be released when program execution for the currently 
processed reader gueue entries is finished, and (3) the POWER/VS 
partition to be released. Your operating system is restored to normal 
DOS/VS operation when message 1021I has been displayed. 


The statement: 

PEND OOF 

causes the same action as in the above example. In addition, a status 
report is printed on the printer with the address 00E by POWER/VS before 
it restores your operating system to normal DOS/VS operation. This 


status report is similar to the one provided by POWER/VS after a warm 
start (see Figure 4-2). 
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Emergency Termination 


When it is necessary to terminate POWER/VS immediately because of an 
emergency situation, use the PEND command with the operand KILL. This 
command causes POWER/VS to terminate immediately and, if a printer 
address is specified, to produce a system dump (printout of virtual 
storage) on the specified printer. 

As a result of a PEND command with the KILL operand, input and output of 
jobs is broken off. A warm start enables you to restart output from the 
beginning of the interrupted job. Input of a job entry that was 
interrupted by the command must be resubmitted completely. 


Two examples of the PEND command with the KILL operand follow. The 
statement: 


PEND KILL 


causes an emergency termination of POWER/VS without a systema dump being 
produced. 


The statement: 
PEND KILL,OOE 
causes an emergency termination of POWER/VS with a system dump being 


produced on the printer with the address 0O0E. 


Your operating system is restored to normal DOS/VS operation when 
Message 1021I has been displayed. 


MULTIPURPOSE UNIT-RECORD DEVICES 

If your installation uses any of these devices for POWER/VS, remember 
that they cannot be used simultaneously for a reader and a punch task. 
If it is necessary to start the reader task for one of these devices 
while the punch routine is still processing, you must first stop the 
punch task using the PSTOP command. For example, the statement: 

PSTOP 00D, EOJ 

causes the device to stop punching on completion of the output for the 
punch queve entry currently being processed by the associated punch 
task. 

The statement: 

PSTOP OOD,RESTART 

causes the device to stop punching output immediately. 

In both cases, POWER/VS displays the message 10933I STOPPED PUN,O00D when 
the punching operation has stopped. You may then start the reader task 


using the command 


PSTART RDR,OOD 


146 POWER/VS Installation Guide and Reference 


After the reader task finishes reading the new input, stop it and 
restart the interrupted punch task. For the above example, the commands 
would be: 


PSTOP OOD 


(assuming that the last card in the read hopper has been read) and, 
following message 10331: 


PSTART PUN,OOD 


Miscellaneous Devices 


USING THE IBM 3540 DISKETTE INPUT/OUTPUT UNIT 


You can use the 3540 unit as a POWER/VS input device, either as a card 
reader (SYSIN mode) or aS a supplement to the card reader (data mode). 
POWER/VS can, for example, read the job control statements from the card 
reader and then switch to the diskette unit to read a data file, or it 
can read control statements and card image data from the diskette unit, 
using no card reader at all. 


The_3540_in_SYSIN_Mode 


For 3540 SYSIN files, a reader task will read either 80- or 81-character 
records from diskette and put 80-character records onto the spool disk. 
The size of the records to be read is obtained from the HDR? label on 
the file and must be 80 or 81 bytes. If the input records are 81 
characters in length, only the last 80 bytes will be copied to the 
POWER/SVS data file. 


If an * $$ RDR statement is read from the diskette, POWER/VS issues a 
message (10901 INVALID * $$ RDR STATEMENT) and flushes to the next 
POWER/VS job on the diskette file currently being processed. 


The SYSIN records can be read only by a user program that is reading 
from a card reader specified at partition start-up as a unit-record 
device to be spooled. Because DTFDU cannot be assigned to a card 
reader, DTFDU cannot be used to access these files. 


Example: Job control statements and data are both on one 3540 SYSIN 
file. The operator enters a PSTART command to start a reader task on a 
3540 diskette (xX*00B'): 


PSTART RDR,X'OOB*,B,*FILE-ID*,31 


Up to 31 diskettes of the file called FILE-ID will be read. Reading 
stops after 31 diskettes or after reading a diskette that does not have 
a continuation indicator in its label. One 3540 file may contain many 
DOS/VS jobs and/or POWER/VS jobs. Jobs with no class specification in 
their * $$ JOB card, or jobs for which no * $$ CTL statement is in 
effect, are put into class B. 


During program exeuction, the records will only be passed to programs 


reading from a card reader that has been specified as the reader spool 
device when starting the partition. 
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For data files, a reader task can read records of from 1 to 128 
characters. These records are not examined for control statements and 
are written onto the spool file exactly as read. The data records 
cannot be read by programs accessing a card reader. They can only be 
read by a user program that is reading from the physical unit specified 
on the * $$ RDR statement. This unit must be assigned to a 3540. 
Either DTFDU or DTFDI can be used to access these files. 


Two or more files per 3540 volume may be specified through the use of 
two or more * $$ RDR statements in the card reader. 


Note that although a diskette file may be inserted into a card input 
stream, it is not possible to insert card data into the middle of a 
diskette file or to insert one diskette file into another. 


The * $$ RDR statement causes a POWER/VS task to insert information from 
a 3580 file into the input being read from the card reader. You do not 
need to submit other JECL statements for a job containing a RDR 
statement. This statement is ignored in a writer-only partition. 


Example 1: The job control statements are in the card reader, data is 


on the 3540. The operator enters a PSTART command for the card reader 
{X*O0O0C*) and input class A: 


PSTART RDR,OOC,A,00B 


This command informs PO#WER/VS to start a reader task at address x*00C! 
with the ability to read from a 3540 at address X*O0OBt also. Both input 
devices belong to the reader task and cannot be used physically by any 
other partition or POWER/VS task until the reader task terminates. The 
following cards are in the card rader (X*00C*): 


// JOB EX1 
ASSGN SYS008,X*OOBS 
DLBL FILE,'FILE-ID',,DU 
EXTENT SYS008 
EXTENT SYS008 
EXEC PROG 


/ 
* $$ RDR DEV=X'00OB*,FID="FILE-ID*,NOD=2 
/* 
/% 


The SYS008 specification in the // EXTENT statements is not required if 
the symbolic unit was assembled into the DTFDU. 


The RDR statement causes the reader to suspend card reading to read up 
to two diskettes of the data file named FILE-ID. Records on the 3540 
may be from 1 to 128 bytes long and will not be examined for control 
statements by either the reader task or the execution processor. When 
the end-of-file identifier is reached, card reading is resumed. 


During the execution of the user program, not all of the FILE-ID records 
spooled by the reader task may be read. To prevent the remainder of the 
records from being passed to job control as SYSIN data (once the * $$ 
RDR statement is reached), any request to the card input spool device 
Will cause POWER/VS to skip records until the end of the FILE-ID file. 
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Example 2: Some job control statements are in the card reader, 
additional job control statements and data are on a 3540 diskette. The 
operator enters a PSTART command for the card reader (X*00C*) and input 
class A: 


PSTART RDR,OOC,A,00B 


This command causes the reader task to insert 3540 data from X*'O0OB* into 
the input stream on the spool disk when an * $$ RDR statement is 
encountered in the card input stream. The following cards are in the 
card reader: 


// JOB EX1 


* $$ RDR FID="TESTJOB? 
// JOB EX2 


The * $$ RDR statement causes the reader task to suspend card reading 
and to read one diskette of a SYSIN file named TESTJOB from the 3540 
specified in the PSTART command (X'00B'). The TESTJOB file could 
contain the following statements, for example: 


// JOB ASSEM 
// BXEC ASSEMBLY 


For more information on the use of the * $$ RDR statement, refer to the 
section "POWER/VS Job Entry Control Language Statements" in Chapter 3. 


Note: POWER/VS will only spool 80- or 81-byte records from the 3540 for 
programs that ask for card input. A user converting from a 
Multifunction Card Unit to a 3540 must change his programs if 96-byte 
records were used. 
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Appendix A. Data Compaction 


Compaction provides a method by which nonduplicate characters may be 
compressed. It takes advantage of the fact that most data streams use a 
relatively small subset of the 256 possible EBCDIC characters. Although 
there are a number of ways to do compaction, only the algorithm to be 
implepented for the POWER/VS SNA support is discussed. 


For compaction, you must supply a compaction table to POWER/VS. The 
process is relatively simple, but you must know the data to be 
transmitted. First, determine the set of all possible characters that 
may appear in the data stream. Next, count the number of possible 
characters, then using Figure A-1, match this number with the closest 
{but not smaller) number appearing in the first column. The second 
column shows how many master characters must be selected for the 
corresponding number of compact code characters. If the number of 
compact code characters is greater than 247, you should specify no 
compaction. 


orate a oe ig es Pa ee Pe OE a ea ee Cee Se pe per es a ee 
[Number of Compact {Number of Master } 
!Code Characters {Characters | 


ee ee ee ce ee i ee ee ee ee a a a i ee ee we ee we we ee we eee es ew ewe eee 


~~ 
~d 
ui 


ES EP om GE qa a OY Ge sate EME cue ores 


Figure A-1. Numbers of Master Characters Related to Numbers 
of Compact Code Characters 


Por example, to choose a master character subset for this appendix, you 
would define the possible characters that may occur as shown in Figure 
A-2. 


Thus you have determined that this appendix may include. up to 85 
different characters. In the first column of Figure A-1, the number 
closest to 85 (but not smaller) is 87. Now increase the number of 
characters in the character set to equal the number from Pigure A~-t. 
For this appendix, you might choose: 


< Less than (xX*act) 
> Greater than (X*6EB*). 


Now, from this character subset, choose the m most frequently used 
characters, where m is the number of master characters in Figure A~?. 
For a large subset of 87, m equals 13. For the m most frequent 
characters in this document, you might select: 


a, d, @, g, i, 1, ny, O, LT, S, t, U, and blank 
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rr Ne 


}Characters | Name |Hex Code | 
Pee irae ier wee an ty reg ra Serre Die ee ae ie ey yn ge ee ! 
jA -~ I | jot - cd I 
iJ - R |Uppercase letters [D1 - D9 I 
1S - 2 i JE2 - E9 | 
Ja - i | 181 - 89 ! 
by Se JLowercase letters 1971 - 99 ! 
js - 2 | fA2 - ag I 
i0 - 9 |Numerals }FO - F9 | 
le | Blank {40 I 
IC jLeft bracket } AD ! 
|. | Period j 48 | 
1¢ [Left parenthesis 14D 1 
[* {Plus sign [45 | 
Ke | Ampersand {50 | 
I] fRight bracket |} 5D 1 
|$ |Dollar sign | 5B | 
{ * fAsterisk [5c ! 
1) {Right parenthesis | 5D | 
1; |Semicolon [5E I! 
[- |Hyphen 160 { 
\/ }Slash 161 I 
te {Comma 1 6B i 
[% | Percent {6c I 
1 |Underscore [6D H 
1? JQuestion mark | 6P | 
12 | Colon {7A { 
| # }Pound sign |7B | 
{a [At sign p7c I 
}? [Single quote {7D | 
|= [Equal sign {7E | 
ad {Double quote | 7P | 


a ele EN ee EO eT | 


Figure A~2. Example of Compact Code Set 


To define the compaction table for POWER/VS, you can specify the 
parameters in the PCPTAB macro as follows: 


PCPTAB MASTER= (a,d,e,g,i,l1,n,0 
NOMAST1=(A,B,C,D,E,F,G,H 
T,U,V,W,X,Y,2,0,c,f£,h,4, 


4B,4D,4E,50,BD,5B,5C,5D,5E,60,61,6B, 
6C,6D,6F,7A,7B, 7C, 7D, 1E, IF, 4C, 6E) 


The macro PCPTAB builds tables using these parameters. For details 
concerning the PCPTAB macro, refer to the section "POWER/VS Generation 
Macros" in Chapter 2. 


To compress and compact the data stream, POWER/VS performs the 
following: 


1. Scans the data, looking for consecutive blank character strings of 
length 2 or greater. 


2. Scans the data, looking for consecutive duplicate character strings 
of length 3 or greater. 
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3. For each string of nonblank and nonduplicate characters, POWER/VS 
then checks if any character is not a member of the set of compact 
code characters (master or non-master characters). If so, POWER/SVS 
creates a string control byte (SCB) for noncompressed and 
noncompacted characters and continues with the next string. 


4. If all characters are in the compact code subset, POWER/VS 
translates the whole string to compact code. Then POWER/VS scans 
the string, looking for two consecutive master characters. Each 
time this occurs, POWER/VS compacts the two bytes into a single byte 
and continues. A fourth kind of SCB describes the compacted string. 


It is important that the compact code subset include all (or almost all) 
characters in the data stream. Otherwise, an entire string may not be 
compacted. 


To illustrate how much reduction can be realized, operate the algorithm 
on the sentence for step 2 above using the example for PCPTAB 
specifications (as coded before). This character string contains 103 
characters, assuming one blank between each word. For step 2, the 
following pairs of master characters are found in order: 


an,s ,e ,da,ta, 1,00,in,g ,or,on,Se,Ut,e ,du,li,at, 
@ ,ar,te,c ,st,Ti,ng,s ,l,en,gt, o, ©,gr,ea,te. 


There are 33 pairs of master characters. Potentially, this sentence can 
be reduced from 96 characters (two SCBs added for nonduplicate character 
string with compression only) to 62. A reduction of about 35 percent. 


A discussion follows of how POWER/VS does compression and compaction and 
how it builds its tables for compaction and decompaction. 


The string control byte (SCB) as defined for SNA is a byte consisting of 
a two-bit string identifier and a six-bit count field. It is defined as 
follows: 


SCB Bits Explanation 


oe ee ee ee ee we ee eee ee 


xx 000000 Reserved. Invalid if present. 


OOxxxxxx Noncompressed characters. The SCB is followed by 1-63 data 
bytes. The number of data bytes is given by xxxxxx. The 
next SCB follows the last data byte. 


OxxxxXx Compact code characters. The SCB is followed by 1-63 bytes. 
Each byte may represent two consecutive master characters, or 
a Single character in the compact code subset; and both kinds 
of bytes may exist in the same string. The number of bytes 
is given by xxxxxx; and it represents the number of bytes 
following the SCB, not the number of data bytes represented 
by the string (before compaction). The next SCB follows the 
last byte. 


TOXXKXXX Duplicate blanks. The SCB represents 1-63 consecutive blanks 
(X*40*). The number of blanks represented is given by 
XxX¥Xxxx. The next SCB follows this SCB immediately. 


TIxxe¥xXxXx Duplicate next character. The SCB and the character 
immediately following the SCB represent 1-63 consecutive 
duplicate characters. The duplicated character is the 
Character following the SCB. The number of duplicate 
characters is given by xxxxxx. The next SCB follows the 
duplicated character. 
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If compression is being done but not compaction, SCBs of the form 
B*O1xxxxxx"® are not valid. 


There are two important rules that must be followed for SCBs: 


e An SCB and its string may not span request unit (RU) boundaries 


¢ Compression and compaction operate on byte strings. 


There is not necessarily any relationship between the boundaries of an 
SCB string and the boundaries of a logical record. A logical record may 
begin or end in the middle of an SCB string. In the same manner, 
Single-character string (SCS) control characters may be compressed as 
well as data. 


The PCPTAB macro builds a set of compaction tables consisting of 256- 
byte tables - a translate-and-test table for compaction (TRTC), and a 
translate table for compaction (XLTC), - and an FMH3 (function 
Management header) ready for transmission to the work station. 


The PCPTAB macro builds the TRTC so that it contains zeros at the 
displacements corresponding to each member of the compact code subset, 
and nonzero values at all other displacements. The XLTC table contains 
meaningful entries only at displacements corresponding to the compact 
code subset members. The values at those displacements are such that no 
compact code character will translate into a byte whose high-order digit 
and low-order digit are less than m, where m is the number of master 
characters. 


The value for the first master character is always X'FO'. The second 
master character gets X*F1*, and so forth, until the master character 
subset is exhausted. If the number of master characters is 16, there 
are no non-master characters, and the XLTC is then complete. If m is 
less than 16, the first non-master character gets X*Pm+1*, and so forth, 
up to X*FF*, 


If m is less than 15, the next 16 non-master characters are assigned 
X'EO' ~- X*EF*. If m is less than 14, the next 16 non-masters are 
assigned X*DO* - X®*DF*, and so forth, until the point is reached such 
that if X'x0" were assigned to the next non-master, both digits would be 
less than m. When that point is reached, the next non~master gets 
X*yz*, where y=m-1 and z=m. The following non-master gets X*yz+1*, and 
so forth, up to X*yF*. The next non-masters get X"y-13z", X*y-tz+4*, up 
to X*y-7F*. Each time X*yF* is reached, the high-order digit is reduced 
by 1, until the last non-master gets X'OF*. 


Using the example from this appendix, the tables generated with the 
PCPTAB macro are as shown in Pigures A-3 and A-4. For the TRTC table, a 
dash represents any nonzero value. For the XLTC table, a dash 
represents any value, because such a character will not occur in the 
string. 
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eee eee we ee in ee ee ee ee ee wm ee ee ee ee ee ee we es en ee a oe we tr ee 


Oxf- - - - = - - - = = = = = = = = 
WwJ- - - - = = = = = = =~ = = = = = 
2xfr 7 7 tT tt ee ee ee 
Bxl- - - - - - = = = = = = = = = = 
4xj00 - - - - - - = = = 00 00 00 00 00 - 
5x}00 - - - - -~ - = = = 00 00 00 00 60 - 
6xf}00 00 - - - - - = = = = 00 60 00 00 00 
Ix[- - - - = - - - 


8x}- 00 00 00 00 00 00 00 00 00 - - - - = = 
9x}- 00 00 00 00 00 00 00 00 00 - - - - - = 


oO 
Oo 
Q 
Oo 
co] 
QoQ 
o 
o 
>] 
i] 
o 
Oo 
ey ee ee eee es ee ee es eee ee ee ee ee ep ee oe od 


Ax|]- - 00 00 00 00 00 00 00 00 - - - - - - 
Bx. So ee er oe ee ee a es SS ee 
Cx|- 00 00 00 00 00 00 0000 00 - - - - - = 
Dx{- 00 00 00 00 00 00 0000 00 - ~ - - - - 
Ex[- - 00 00 00 00 00 00 00 00 - - - - - - 
Fx{00 00 00 00 00 00 00 00 00 00 - - - - - = 


Pigure A-3. Translate-~and-Test Table for Compaction (TRTC) 


oe ee ee ee ee ee ee re ee ee ee ee ee ee ee ee ee ee ee ee ie ee eo oe, 


Oxl- - - - = = = = = = = = = = = = | 
ixJ- - - = = = = ee ewe ee ew ew ee 
2xf- - - - - = = = = = = = ee ee 
3xf{- - - - 7 oe te er et ee er ee ft 
Gx{PC - - = - - - += - = 6D 6E FD 6F 5D- | 
5xI5B - - - - - - = = = 5F 4D UE UP 3D - | 
6x|38 3F - - -~ - - - - = - 2D 2E 2F FE ID | 
IxJ- - - - - - + = = = 148 1F FF OD OF OF } 
8x{- FO EO E1P1F2 E2 F3 E3 PH - - - - = =~ f 
9x{- E4 E5 FS B6 F6 F7 E7 EB F8B~ -~ - - -— - | 
Ax|- - F9 FA FB £9 EA EB BC ED- ~- - - - - | 
BxJ- - - - = = = = = = = = = = ee YY 
Cx|- EE EF DO D1 D2 D3 D4 DS DE - -~ - -~ -~ - 4 
DxJ- D7 D8 DI DA DB DC DD DE DF - - - - - - 4f 
Ex|- - CD CE CP BD BE BP AD AE- ~ - - - - | 

| 


Fx|AP 9D 9E 9F 8D 8E 8F 7D 7E 7F - - - - - - 


Figure A-4. Translate Table for Compaction (XLTC) 


POWER/VS uses the TRIC and XLTC tables in the following way to perform 
data compaction: 


POWER/VS first scans the data to separate strings of duplicate data fron 
strings of nonduplicate characters. Then POWER/VS scans the 
nonduplicate strings for characters outside the compact code subset 
uSing the TRTC table. 


If a character outside the compact code subset is found, POWER/VS does 
not attempt to perform compaction. The string goes into the request 
unit aS a noncompressed string. If all characters are members of the. 
compact code subset, POWER/VS translates them to compact code, using the 
XLTC table. 


POWER/VS then scans the data, looking for two adjacent master characters 
and combines these characters into one byte. 
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The example below shows how this algorithm works for the following 
sentence: 


"7. Scans the data, looking for consecutive duplicate character strings 
of length 3 or greater." 


This would appear in storage (in hexadecimal) as: 


FIUBYOE2 83819582 40A38885 408481A3 81684093 96969289 
95874086 96998083 9695A285 83A4A389 A53854084 A4979389 


8381A385 40838881 998183A3 859940A2 A3998995 87A24096 
| 86409385 9587A388 4OF34096 99408799 8581A385 9948 


POWER/VS would first scan the string, looking for consecutive duplicate 
character strings of length 3 or greater. No such string exists in the 
first 63 characters, so POWER/VS would establish the 14 (X'F1*") as the 
beginning of a non-duplicate string, and the blank (X*40") character 
between the words ‘character’ and ‘'strings® as the end of the 
nonduplicate string. POWER/VS then tests this string, using the example 
TRTC table, and finds that all characters are members of the compact 
code subset. POWER/VS then translates the whole string to compact code, 
using the XLTC table. The resulting string (first 63 bytes only) 
becomes: 


S9D6EFCCD BIFOF6F9 FCFAE3F2 FCFIFOPA FO2DPCF5 FP7P7ESF4 


F6P3FCE2 FVF8FCE1 P?F6F9F2 EIFBFAPY ESP2FCF1 FBE7FSF4 
EMFOFAF2 FCE1E3F0 FSFOEIFA P2FSFC 


Now POWER/VS scans the string, looking for two adjacent master 
characters. The target buffer for this example then becomes (first byte 
is the SCB): 


6A9D6EFC CDE1069C PAE32C10 a02D 


92E1BAF4 E92CIBE7? 5HE10A2C E 


The underlined bytes represent two master characters. Thus, 63 
characters have been reduced to 43, including the SCB. 
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Appendix B. RJE, SNA I/O Specifications 


This appendix describes the major functions of POWER/VS RJE,SNA with 
respect to the handling of input and output information. Data directed 
from a peripheral device to the host system is referred to as inbound 
data; information directed from the host system to a peripheral device 
is called outbound data. 


POWER/VS processes the following types of inbound data: 
e Console data 


e Card data. 


In the outbound direction, the following information can be processed: 
e Print data 
e Punch data 


* Console data. 


The following sections discuss the handling characteristics for these 
types of data. Additionally, a summary of the support for Data Flow 
Control (DFC) reguests is also provided. Refer to Figure B-4 for a 
support summary of the POWER/VS RJE,SNA data communication facilities, 
to Figure B-5 for a summary of the single character string (SCS) control 
characters supported by POWER/VS RJE,SNA, and to Figure B-6 for an 
overview of the data stream interruptions supported by POWER/VS for SNA 
terminals. 


Inbound Console Data 


POWER/VS assumes that inbound console data exclusively consists of 
commands, and treats this information as such. It deblocks each RU into 
80-byte images using the same scanning algorithm as described later in 
the section "Inbound Card Data". Inbound console data may be 
transparent or nontransparent; however, POWER/VS does not support 
conpression for inbound console data. 


inbound Card Data 


Inbound card data consists of one or more jobs, delimited either by 
DOS/VS JCL job delimiter statements (// JOB and /&) or by POWER/VS JECL 
job delimiter statements (* $$ JOB and * $$ EBOJ). Figures B-1 and 3-2 
give examples of these two types of inbound card data streams. 
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co eee” eee See 


4 
1 // JOB A Start job | 
!. | 
| - I 
|. | 
| /#& End job I 
| // JOB B Start job | 
| ! 
[ - | 
I - ! 
| /& End job | 
| * .. START LST,class See note t 
{ * .. START PUN,class | 
| * .. DISPLAY RDR,class 1 
| “7 JOB C Start job | 
| // EXEC PGM 1 
| data } 
}- ! 
|. I 
1s I 
| /* | 
1 /& End job | 


| ee | 


Figure B-1. Inbound Card Data with DOS/VS JCL Job Delimiters 


Note: You may enter remote operator commands punched in cards; however, 
these will only be recognized and acted upon when they are submitted 
between DOS/VS or POWER/VS job boundaries. 


—— 


} * $$ JOB Start job } 
| - I 
| - | 
} - 1 
| * $3 EoOJ End job | 
| * .. START LST,class See note | 
| * .. START PUN,class | 
| * .. DISPLAY RDR,class | 
{ * $$ JOB Start job 1 
| “7 JOB A | 
} . | 
I. | 
{ . I 
| /& | 
| // JOB B | 
| // EXEC PGM | 
| data ! 
|. | 
I. | 
| - ! 
| /* | 
| 7#& | 
| * $$ EOJ End job | 


vr ee | 


Figure B-2. Inbound Card Data with POWER/VS JECL Job Delimiters 
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Note: You may enter rerote operator commands punched in cards; however, 
these will only be recognized and acted upon when they are submitted 
between DOS/VS or POWER/VS boundaries. 


Inbound card data may be transmitted from a card reader or a disk 
{optional device on certain work stations). POWER/VS treats both device 
types identically. 


If POWER/VS did not encounter a valid job delimiter at the end of 
inbound data transmission (that is, either a /& or a * $$ EOJ 
statement), it will add the appropriate job delimiter. Then the job is 
placed in the Hold queue, and a message is sent to the originating 
remote operator stating the disposition of the job. The operator nay 
then issue a command to release or to delete this job. 


Data from a work station is transmitted in the form of request/response 
units (RUs) which may be up to 256 bytes long. POWER/VS deblocks each 
RU and creates 80-byte card images using the following algorithr: 


1. The first 80 bytes of the RU are scanned for a record delimiter (SCS 
character). 


2. If no record delimiter is detected, an interchange record separator 
(IRS) is assumed to follow the 80 bytes. 


3. If the next (81st) byte is a record delimiter, it is ignored and the 
next logical record is assumed to start with the 82nd byte. 


4. If the 81st byte is not a record delimiter, this byte is assumed to 
be the first byte of the next logical record. 


5. If a record delimiter is found before the 80th byte, this delimiter 
is discarded and the record is padded with blanks to 80 bytes. The 


byte following the record delimiter is considered to be the first 
byte of the next logical record. 


Outbound Print Data 


For print jobs, POWER/VS supports the following SCS functions: 
e S®LECT CHANNEL nn 

* FORMS PEED 

e CARRIAGE RETURN 


e NEW LINE 


These functions are briefly discussed below. 
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re ee ee et Ee a Oe eg pe a ee ne 
JSELECT CHANNEL nn (SELnn), X*O04nn*]| 
a ee ee, 


This command is inserted after a print line if the request was to skip 


to channel nn after printing. The following codes apply: 


Channel Hexadecimal 
Representation 


1 x'stt (see note below) 
2 x'82!* 
3 x¥*83°8 
T x*sat 
5 x*s5? 
6 x*86?* 
7 X*s7? 
8 x*s8? 
9 xX*89? 
40 X* 7A? 
11 X"7B* 
12 x*7c°8 


Note: If SELO1 is specified, this value is converted to, and 
transmitted as, the FORMS FEED character (X*"OC*). 


Go ye re ae ee ee ee 
}FORMS FEED (FF), X*0C*f 
| ee ee ee Ree 


This command is transmitted instead of the SELECT CHANNEL 1 command. 


Ce ee ee 
JCARRIAGE RETURN (CR), X*OD®| 
ee | 


This command is inserted after the print line if the request was to 
print with no space. 


Co Cy Ee SO Oe eee 
[NEW LINE (NL), X*15"] 
Ni i ell 


This command is inserted before or after the print line depending on 
whether the reguest was to space one line before or after printing. If 
two or more blank lines are requested, the appropriate number of NL 
commands are inserted. 


Notes: 


1. POWER/VS does not support the Select Vertical Format (SVP) feature. 
Therefore, it is the responsibility of the remote operator to set up 
the vertical tab tables at the remote work station. However, the 
PCB name is sent if PDIR is supported and if the name has been 
specified in the * $$ LST or * $$ PRT statement. 


2. The maximum logical record length is 132 bytes. 
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Outbound Punch Data 


Outbound punch data consists of one or more punch jobs from the output 
class specified in the START PUN[,class] command by the remote operator. 


The punch data stream is transmitted in transparent mode unless ASCII 
was specified in the BIND parameters for that work station. Compression 
and compaction are not supported for punch output. 


Each logical record is vreceded by a TRN byte and a 1%-byte binary count 
indicating the number of bytes of transparent data. Trailing blanks are 
truncated so that the data count for each record is less than, or equal 
to 80 bytes. An IRS character follows each logical record. The TRN and 
the IRS characters are the only two SCS characters supported for punch 
output. 


Outbound Console Data 


Outbound console data consists of messages. The message processor uses 
the NL character to properly format each message. The NL character is 
the only SCS character used by the message processor. 


Data Flow Control (DFC) Requests 


Figure B-3 shows the DFC requests supported for both inbound and 
outbound SNA support. 


Conor oe = ge Oe eppe ae PSs ge Oh, Fp te coe ee 
{DFC Request J Inbound jf Outbound 1 
ee ee i ew we ee ae ae i ee a ee ee | 
| CANCEL | YES JYES | 
{SIGNAL |YES {NO | 
JLUSTAT | YES {N/A j 
| CHASE [NO {NO ! 
|SHUTD [N/A }NO | 
|}SHUTC jNo |N/A { 
{RSHUTD {YES [N/A | 


Figure B-3. DFC Request Support for SNA 


INBOUND DFC REQUESTS 


CANCEL: CANCEL may be received at any time. If received during in- 
chain-state, POWER/VS will discard the current job being 
received, that is, POWER/VS will not place it into the input 
queue and will free the resources. A positive response is 
sent to CANCEL. If received during between-chain state, 
POWER/VS will positively respond to CANCEL but take no 
further action. 
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SIGNAL: 


LUSTAT: 


CHASE: 


SHUTC: 


RSHUTD: 


SIGNAL indicates a request for change in direction. If 
outbound processing is performed, POWER/VS will force the 
end-of-chain and send CD with FMH1 indicating suspend, 


If POWER/VS is in receive or standby state, SIGNAL will be 
ignored. The positive response to SIGNAL is sent by VTA 
automatically. 


The following LU status codes are supported by POWER/VS: 


X*0001XX00" Component now available, 
X*081CxXx00* Component failure: permanent error for an 
outbound device. 


where XX = device selection byte of FMH1. 


All other codes and conditions will be negatively responded 
to, the outbound processor sends ADS (if in DS state) and 
terminates. 


CHASE is not supported. A negative response indicating 
function not supported is returned. 


Shutdown Complete is not supported. This should never be 
received as it is only returned in response to SHUTD which is 
not sent by POWER/VS. 


Request Shutdown is interpreted by POWER/VS as a request for 
CLEAR,UNBIND when the current active processor completes. 


The inbound processor waits for an FM Header indicating Abort 
or End Data Stream with EB or CD. 


The outbound processor completes the sending of the current 
job(s) and any pending messages, then terminates the session. 


OUTBOUND DFC REQUEST 


CANCEL: 


CANCEL will be sent by the outbound processor whenever a 
negative response is received, and during in-chain-state. 
There are no other conditions under which POWER/VS will send 
CANCEL. 
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|POWER/VS RJE,SNA 
|Pacilities 


| Compression 


| Compaction 


| 
[RU Spanning 


| 
JASCII Characters 
I 


{Truncate Blanks 


| Transparency 


{ 
|FMH Type 


Notes: 


}Inbound Data 


{Console {Card 
|No [No 

I I 

[No J|No 

| ! 

[No | No 

| ! 

}Yes !Yes 

| | 

| Yes (2) | Yes (2) 
l 1 

| Yes (1) {Yes (1) 
I | 

}7 1 

Jand default] 


1. If ASCII is not specified. 
2. Depending on the work station. 


{Outbound Data 
| eee ee woe wee ae a se sem cee es Sao ae ee a a es ere a ee se 


jPrint 


|} Yes (1) 
t 
| Yes (1) 


{Yes 


| Yes 


1 
|No 


| Punch 


!Console 


v3 
© 
u 


ce ee ee eee ee ee ee we ee oe ee ee ee ees ee ee 


ess ra = rssh SS Spf gs nt NNR ssa eee 


Figure B-4&, 


Data Communication Pacilities Supported by POWER/VS RJE,SNA 


nr 


[POWER/SVS SNA SCS (Single 
jcharacter string) control 
{characters supported 


| Character 


{New Line (NL) 
I 


|Carriage Return (CR) 


| 
{Forms Feed (FF) 


JInterchange Record 


|Separator (IRS) 
| 


{Select Channel (SEL) 


| Transparency 
! 


{Required New Line 


| (RNL) 


Figure B-5. 


(TRN) 


{Value {Card 
}xX*15* |fYes 
ore ee 
Hace ae : 
Ix"tg! ves | 


1 

I 
[x*O&xx*fNo 
| 

}x*35! 


t{x°06" {Yes 


| 
! 
| | 
|Yes ] 
| 
| 
| | 1 


Appendix B. 


|Data Inbound 


I 


|Console]Punch 


|Data Outbound 
jto Host System |from Host Systen 


{Print jConsole 
[Yes }Yes 
I | 
|Yes {No 
| j 
|Yes [No 
! 
| No |No 
| 1 
| I 
|Yes [No 
| l 
[No JNo 
| | 
[No [No 
1 | 
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i 
t 


Jinterrupt 


Jot 


ee cme cee ee ce ee ee me ee ee ee ae em ce ee mee ce re cm rr ne re ee ee ee ee ee ee ee ee ee ce ee ee ee i ee ee 


l ! | 

| { | 

| Console / |No 

| | ! 

| card |Yes(2) | i. 
| I | 
JOutbound data | | 

| i | 

| Print |Yes {Yes 
! | ! 

I Punch |Yes jYes 
I | | 

| Console {No | No 

i | | 
JOutbound data already inter- | | 
[rupted by inbound card data 1 | 

| | | 

| Print |Yes(2) {No 

| | ! 

| Punch }Yes(3) |No 

} cm ee ae ee ewe ee we oe a ee ae ee i a ne a a we ee ee ee ee ee 
!Notes: 

1171. If CONSOLE=YES in PRMT macro. 

}2. Function not available for the 3770. 
{3. Function not available for the 3770 and 3790. 


I 
Inbound data 


Interrupt by |Inbound data 


JOutbound data 


z 
e) 


Zz 
° 


2 2 Zz 
o 0 


{Punch 


z 
1°) 


Zz Zz 
° °) 


=z 
1°) 
t 


oe ee ee te ee ce ee ee ee ee ee ee ei i ee we ie ee 


|Console | 


<4 
ie) 


z 
i?) 


Zz 
co) 


—— ae eee ee eee Oem eee eee ee ees wep vere eee ee ee eee ee we ee ee eres > ee ee oe oe 


Figure B-6.. 
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Data Interruptions Supported by POWER/VS RJE,SNA 


Appendix C. LOGON Mode Table and BIND 
Parameter Requirements 


To use POWER/VS with RJF,SNA, you must have generated VTAM under your 
DOS/VS operating system. This appendix concentrates on the LOGON mode 
(LOGMODE) table to be defined during the VTAM generation. One entry is 
required in the LOGMODE table for each individual group of sessions with 
identical VTAM BIND characteristics. 


The LOGMODE table, which must be cataloged in the VTAM core image 
library (private or system), contains the BIND parameter specifications 
as required for each individual group of sessions. As a remote 
operator, you must specify the name of the appropriate entry in the 
LOGMODE table when you issue the LOGON command. For details concerning 
the BIND parameters in general, refer to the DOS/VS VTAM System 
Proqrammer's Guide, GC27-6957. 


The following example (Pigure C-1) shows the definition of a LOGMODE 
table entry by means of the MODEENT macro. Note that the continuation 
characters that must be specified in column 72 have been omitted in the 
example. 


4 
| Byte no.| 
! in BIND } 
jusername MODETAB ! 
! I 
jusername MODEENT LOGMODE=name, j 
| ! 
| FMPROF=X*03', 2 | 
[ ] 
| TSPROF=X'03!°, 3 t 
| | 
! PRIPROT=X*a3", 4 | 
| =X*°AT®, (without compression (LST,PUN)) | 
{ ! 
| SECPROT=X*A1', 5 i 
| ! 
! COMPROT=X"7080°, 6,7 | 
I =X'7880", (with ASCII (3770 only)) ! 
| ! 
| RUSIZES=X *8585°8 8,9 | 


Figure C-1. LOGON Mode Table Coding Example 


Figure C-2 shows the BIND parameters for the presentation services to be 
used with a 3790 or 3777 work station. The string of 12 hexadecinal 
values applies to bytes 14 through 25 of the BIND parameters. 
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Byte no. in BIND 14 15 16 17 18 19 20 21 22 23 24 25 


PSERVIC=X'’ 


00 RDR not allowed (3790 POWER) 
40 ROR allowed 


PDIR (information about COPY count, chain, FCB buffer! 
COMPACTION to POWER from 3790 
PD1IR + COMPACTION 


00 ~=—~Print output for 3790 
not allowed 


80 ~—s— Print output allowed 


Figure C-2. BIND Parameters for the Presentation Services 
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Appendix D. Examples of 
Status Report Output 


This appendix describes two status report examples for the IBM 3800 
Printer. They show the status report output that results when you issue 
the PDISPLAY command shown. In each example, the numbered notes 
describe the item indicated with the same circled number on the listing. 
Example 1. If you issue the PDISPLAY command: 

d lst 


the status report has the following form: 


Fi IR46I LIST QUEUE P C FROM TO PAGES CC FORM 
First job ee TR46I PWROO1 00162 3 B 000 000 3 *8 FPRFF 
Fi IR4&6I FLASH=FLSH,BURST,COPIES= 36 
Second job {F1 IR46I PWROO2 00170 4 H c 000 000 518 1 ABCD 
Third job F1 IR46I PAYROLL 00172 8 K P 000 000 1815 *2 PAYF 
F1 IR46r LASH=PAYR,COPIES= 43 
Notes: 


1 The name of the output job is PAYROLL, and it has an associated job 
number of 172, a priority of 8, a disposition of K (keep), and an 
assigned class of P. The job input has been read from a local 
reader device, and the output is to be printed on a local printer. 
The job output contains 13815 pages. 


The asterisk indicates that the output file is destined for printing 
on a 3800 Printing Subsystem. 


wW) 


3 The output is printed twice (that is, the transmission count is 2). 
4 The forms overlay name is PAYR. 


5 The total number of copies produced for this job is 4 (although the 
output is only transmitted twice across the channel). 


6 The forms number requested for the job is PAYF. 

7 “BURST” indicates that the paper must be threaded through the 
Burster-Trimmer-Stacker before printing of job PWRO01 can be 
started. 

Example 2. If you issue the PDISPLAY command: 
doa 


the status report has the following form: 
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F1 IR48I LST,OOE,T ,2 POWERM12 00008 A 
F1 IR4&8I F2,00C,A INACTIVE 
F1 IR48I RDR,OOC,A INACTIVE 
Notes: 
1 "'RDR" indicates the type of task. Possible types are: 
LST -- writer task 
PUN -- punch task 
RDR -~- reader task 
BG-F6 -- execution task. 
2 ™"o00c" is the unit record device address associated with this task. 
3 This position shows the class or classes that can be processed by 
the task. The order in which the classes are specified shows the 
order of processing. 
4 This position indicates the number of buffers used, where: 
1 = 1 print buffer 
2 = 2 print buffers, 1 input buffer for data file 
D = 2 print buffers, 2 input buffers for data file. 
5 This identifies the job name and job number of the job currently 
being processed when the task is active. 
6 This is the job class associated with the job. 
7 This indicates that the corresponding task is inactive. 
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Appendix E. Reader Exit Routine 


Por a user-written reader exit routine, you must consider the following: 


POWER/VS performs a conversion to uppercase characters for all POWER/VS 
JECL and DOS/SVS JCL statements (column 1 to 72) that start with // in 
columns 1 and 2. DOS/VS comment statements and ASSGN statements without 
// (permanent assignments) will not be translated. 


The routine receives control from POWER/VS only for DOS/VS JCL or 
POWER/VS JECL statements. It must be reentrant if it is called from 
more than one partition; and it must be self-relocating unless the 
relocating loader option is in effect. 


Any JCL or JECL statement can be changed or deleted and other statements | 
can be inserted. The original statement is presented again after each 
inserted statement has been processed. When all the insertions have 

been made, a return code of X*00" or X*0O4* is placed in register 15 to 
accept or delete the original statement. 


When the reader exit routine receives control from POWER/VS, register 0 
contains the address of the statement read and register 1 the length of 
the statement. To return to POWER/VS, issue a BR 14 instruction. 
Between entry and exit of this routine, no operation may be performed 
that might cause a WAIT condition for the POWER/VS partition. 


The user-written exit routine must not alter the contents of registers 
10, 11, 12, and 13. These registers are reserved for POWER/VS internal 
use. Register 11 points to the task control block of the read task and 
may be used to identify the task. 


Before returning control to POWER/VS, you must specify a return code in 
register 15. POWER/VS expects one of the following return codes: 


X'O0O0* Normal return; process this statement. 

X*'O4* Delete; ignore this statement. 

X*O8" Insert; process new statement, return original statement to the 
user. Any number of statements may be inserted. Preceding every 
job control statement that has to be inserted, one byte must be 
reserved. This byte is used as an interface with the POWER/VS 
message service when the job control statement is incorrect. 

X*'Oc* Flush the DOS/VS job. 

X*10" Flush the POWER/VS job. 

When new statements are added (return code X*08'), the address of the 

statement pust be provided in register 0 and its length in register 1. 

The length must be X'50*. 


Flush conditions (return codes X*0C* and X*10") at job boundary (first 
card of a POWER/VS job) will be ignored and message 1?R57I will be logged. 


If ACCOUNT=YES was specified, the number of records read in the reader 
account record will include records added or deleted through the RDREXIT 
routine. 


If a reader exit was generated and AUTOSTART is to be performed, the 
user must return to POWER/VS with xX*00* in register 15. 


Appendix E. Reader Exit Routine 169 


Bibliography 


DOS /VS System Management Guide, GC33-5371 


ee te ee lee re cee ae a ee ce Se ee Se le pe eS Se SE Se ee ee ee Se ee ee ee AE SS ee ee en SS Ee eS SS SS a SS ol ee SS le 


DOS/VS_VTAM System Programmer*s Guide, GC27-6957 


DOS/VS_POWER/VS Work Station User's Guide, GC33-6049 


ee i le ce ee ee ee ee ee ee oe ee eee ee eee 


DOS/VS_POWER/VS Logic Part 1, SY33-8576 


DOS/VS_ POWER/VS Logic Part 2, SY¥33-8577 


IBM System/370 Model 125 Functional Characteristics, GA33-1506 


BM 2701 Data Adapter Unit, GA22-6864 


omponents;: IBM 2770 Data Communication System, GA27-3013 


4 _ — ss 


Component Description: IBM 2780 Data Transmission Terminal, GA27-3005 


a A a LR A RT 


Component Description for the IBM 3780 Data Communications Terminal, 
GA27-3063. 


Bibliography 171 


$JOBACCT phase 123 
*abc operand 

in PALTER 55 

in PDELETE 58 

in PDISPLAY 61 

in PRELEASE 67 
// EXEC statement 21 


ACB 
(see application control block) 
account file 116,2 
formatting of 133 
Size of 13 
account records 116 
adding resources 9 
additional extents for data 
file 132 
adjusting forms alignment 69 
algorithm for RU deblocking 159 
alignment of forms 69 
ALLOC 21 
allocation of storage 130,7 
ALLOCR 217 
ALLUSERS 
message processing 57 
parameter 57 
application control block 143 
ASCII 33 
attention routine commands 51 
automatic start-up 126 
AUTONAME 82 
AUTOSTART facility 126,130 
AUTOSTART feature 51 
AUTOSTART statements 
errors in 126 
example of use 134,135 
FORMAT 126 
PRINTERS 127 
PUNCHES 128 
READER 127 
sequence of 135 


BIND parameters for presentation 
services 166 
bit settings for ICA line mode 49 
breakdown 7 
broadcast message text length 57 
BSC line 142 
BSC terminals 2 
buffer expansion 37 

additional 37 
Burster-Trimmer-Stacker (IBM 3800) 93 


calculation of GETVIS pool 

size 30 

carriage contral tape 90 

carriage return command 161 

central operator commands 51 
short from of 51 

central operator functions 5 

changing attributes of 
POWER/VS jobs 54 


Index 


Where more than one page reference is 
given, the major reference is first. 


channel selection codes 161 
channel 1 skip 90 
channel 12 
repeated posting of 30 
character arrangement table 
specification 93 
class specification 
changing of 138 
Partition-dependent 138 
partition~independent 138 
clear the 3800 page buffer 31 
CMPACT parameter 36 
coding work Sheet 42,43 
compact code 151 
example of 152 
compaction 151 
compaction rules 40 
compaction table 151,36 
definition of 152 
generation 38 
identification 38 
name 39 
phase name 40 
Storage 15 
component selection (on IBM 
3780) 37 
compression 154 
of nonduplicate characters 151 
COMPROT parameter 165 
conditional termination 145 
CONSOLE parameter 
restrictions 36 
for single logical units 36 
for multiple logical units 36 
for the 3790 36 
copy count display 60 
copy group index 68 
copy groups (IBM 3800) 89 
copy modification (IBM 3800) 95 
copy separator pages/cards 31,83,98 
correction of JECL statements 
during job execution 77 
* $$ LST 85 
* $$ PRT 85 
* $$ PUN 95 
CR 
(see carriage return command) 
cross-partition communication 22,51 
macros 106,4% 
return codes 115 
CTLSPOOL macro 112,29 
NEWVAL parameter in 1714 
request code specification in 113 
restrictions 4,112 
use of 136 
use of operator commands in 114 


data block size 
assumtions 26 
for IBM 3211 printers 26 
for tape or disk intermetliate 
storage 26 


Index 173 


data compaction 151,56 
example 152,154 
data-driven output segmentation 85 
data file 2 
additional extents 132 
block size 12 
entries in 7 
formatting of 133 
track group size 13 
data flow control request 157 
inbound 162 
outbound 163 
support of 162 
data mode 100,148 
data stream interruptions 164,157 
deblocking of RUS, algorithm 159 
default priority 27 
defaults for IBM 3800 94 
defining RJE,BSC lines 32 
DFC request 
(see data flow control request) 
direct access storage devices 
support of 2 
direction of RJE job output 7 
diskette files 100 
in SYSIN mode 147 
in Data mode 148 
diskette unit 147 
display of copy count 60 
DOS/VS 
JCL statements, conversion of 79 
procedure library 134 
special considerations 22 
supervisor generation 
requirements 22 
dual code feature (IBM 2701) 33 
dual communication interface 
(IBM 2701) 33 
dummy devices 135 
dump 146 


EBCDIC 33 
eject~and-feed option 101 
emergency termination 146 
entering POWER/VS commands 136 
EOJ operand of PSTOP 73 
errors in AUTOSTART statements 126 
example 
of AUTOSTART procedure 134,135 
of POWER/VS initiation 130 
of POWER/VS status report 132 


FCB 

(see forms control buffer) 
FF 

(see forms feed comnand) 
file verification 101 
fixable area 14,15 
flashing forms overlays 94 
flushing reader task 64 
flushing writer task 64 

with several output copies 64 

PMPROF parameter 165 
FOPT macro 
YECB specification in 22 


format 
of central operator commands 52 
of JFCL statements 77 


FORMAT statement 1726 
formatting POWER/VS files 133 
forms alignment 69 

forms control buffer 91,27 
forms feed command 160 

forms overlay (IBM 3800) 94 
forms specification 88 


generating DOS/VS supervisor 22 
generating POWER/VS 24 
GETSPOOL macro 111,29 

LINENO parameter 112 

required queue entry disposition 
GETVIS area 14,16 
GETVIS pool size 

calculation of 29 


horizontal format control 37 


I/O trace 37 

IBM 2560 49 

IBM 2770 
required features 44 
supported features 45 
supported I/O units 44 
transparency feature 45 

IBM 2780 
required features 45 
supported features 4&5 
transparency feature 46 

IBM 3525 50 

IBM 3540 diskette I/O unit 147 

IBM 3741 
compatibility with IBM 2780 46 
required features 46 

IBM 3771 46 
attachable devices 46 

IBM 3773 46 
integrated diskette 46 

IBM 3774 47 
attachable devices 47 

IBM 3775 47 
attachable devices 47 

IBM 3776 47 
attachable devices 47 

IBM 3780 
components 48 
required features 48 
supported features 48 
transparency feature 48 

IBM 3790 49,9 
attachment to host system 49 
logical devices 49 
RJE work station package 49 

IBM 3800 
JECL statement parameters 89,93 
POWER/VS generation parameters 
support 50 

IBM 5425 49 


174 POWER/VS Installation Guide and Reference 


31 


114 


ICA line mode 
bit settings 49 

ICRXECB 107,109 

improving system efficiency 9 

INACTIVE status 66 

inbound card data 
characteristics 157 
interruptions 164 


inbound console data 
characteristics 157 
interruptions 168 
inbound data 157 
initiating POWER/VS 129 
with AUTOSTART 134 
without AUTOSTART 130 
inserting diskette files 100 
installation planning 10 
installation prerequisites 10 
installing POWER/VS 10 
interchange record separator 150,162 
intermediate storage requirements 11 
IOTAB macro : ‘ 
specification of LUB entries in 22 
IRS 
(see interchange record separator) 
ISTLINK7 24 


JECL 
(see job entry control language) 
JECL commands 136 
JECL delimiter statements 
end of job 105 
end of jobstep 105 
JECL functions 77 
JECL statements 
* $$ CTL 81 
* $$ DATA 81 
examples 103,104 


* $$ EOI 82 

* $$ JOB 
positional 82 
keyword 83 

* $$ LST 
positional 85 
keyword 86 

* $$ PRT 
positional 85 
keyword 86 

* $$ PUN 
positional 95 
keyword 96 

* $$ RDR 


‘positional 100 

keyword 100 
* $$ SLI 101 

examples 103,104 
execution-time corrections 77 
format of 77 
functions of 77 
keyword parameters 78,80 
positional parameters 78,30 
restrictions 80 
summary -79 
use of 79 


job accounting 116,51,4 

job control 3 

job deliniter statements 
DOS/VS job control 157,75 
POWER/VS JECL 157,75 

job entry control language 51,75 

job execution 3 

job input 3 

job names 
one-character names 83 
restrictions 83 

job output 3 

job segmentation 29 

job separation 28,88,98 


length of broadcast message text 57 
LINENO parameter in GETSPOOL 111 
link-editing NCP modules 
job stream 24 
list queue entry 85 
list task 140 
local unit record I/O devices 
support of 2 
LOGGED ON status 66 
LOGGING ON status 66 
logical boundaries for segmentation 124 
logical reader 9 
logical printer 9 
logical punch 9 
logical unit 143 
logical unit name storage 15 
logical unit buffer limit 23 


‘logical unit names 


avoiding nawes 5OJ and ALL 23 
LOGMODE 165 
LOGON pode table 165 
coding example 165 
LOGON storage 15 
LOSTERM exit 144 
LST operand 
use for different reports 92 
LU 
(see logical unit) 


machine requirements 10 
macros 
accounting support 123 
cross-partition communication 106 
POWER/VS generation 24 
segmentation 124 
mark form function (IBM 3800) 31 
master characters (compaction) 
number of 39,151 
range 151 
rules 40 
selection of 151 
special characters 40 
maximum resource requirements 9 
minimum storage requirements 9,10 
MLU 
(See multiple logical unit) 


Index 


175 


MODFENT macro 165 

multiple channel 12 posting 30 

multipurpose UR devices 134 
interrupting operations on 146 
restarting interrupted operations 

muiltivolume files 89,148 


NCP 
{see network control program) 
NCP requirements 23 
nested SLI statements 106 
network control program 8 
new line command 161 
NL 
(see new line command) 
NOLOG option 75 
non-master characters (compaction) 39 
rules 40 
number of 40 
special characters 40 
normal termination 145 
NOT INITIATED status 66 
NOT LOGGED ON status 66 
NOT SUPPORTED status 66 


outbound console data 
characteristics 161 
interruptions 164 

outbound data 158 

outbound print data 
characteristics 159 
interruptions 164 
scsS functions supported 160 

outbound punch data 
characteristics 161 
interruptions 164 

output segmentation 124,51 
count-driven 4,75 
data-driven 4,85 
program-driven 4 

output spooling to tape 89,98 


PACCOUNT command 53 

examples 54 
pageable area 1#,16 
PALTER command 54 

examples 56 

use in CTLSPOOL nacro 114 
partition priority 1 
password 

overriding of 33 
password definition 

in POWER/VS generation 33 

during POWER/VS execution 33 
password specification 

in PLINE macro 143 

in PSTART command 143 
PRRDCST command 57 

examples 57 

length of message text 57 
PCANCEL command 58 

use in CTLSPOOL macro 114 


147 


PCPTAB macro 38 
PDELETE command 58 
examples 59 
use in CTLSPOOL macro 114 
PDISPLAY command 59,138 
copy count indication 
for active task 60 
for inactive task 60 
examples 63 
items displayed 59,60 
status report 59 
example of 167 
use in CTLSPOOL macro 1144 
PEND command 63 
examples 63 
requesting status report 63 
permanent area 14,15 
PFLUSH command 64 
examples 65 
PGO command 65,69 
examples 65 
Dhase name of compaction table 39 


PINQUIRE command 66 
example 67 
restriction for short form 66 
status information 66 
planning the installation 10 
PLINE macro 32 
applicability 25 
POCL 
(See control operator commands) 
POWER macro 25 
POWER/SVS 
account file 123 
accounting support 22 
AUTOSTART 126 
central operator commands 51 
format of 52 
concept 3 
files 2 
initiation 
With AUTOSTART 134 
without AUTOSTART 130 
initiation statements 131 
example 131 
installation 10 
job 
end 82 
start 83 
major functions 6 
partition 
changing priorities of 136 
structure of 14 
phase names 41 
queues 
manipulation of 1 
operator control of 1 
requirements in DOS/VS 7 
RJE task 142 
status report example 132 
storage allocation 130 
storage requirements 13 
task 


176 POWER/VS Installation Guide and Reference 


POWER/VS (continued) 


activation of 133 
deactivation of 140 
terminal suvport 48 
termination 
emergency 146 
normal 145 
POWER/VS application name 
svecification for VTAM 30 
POWER/VS generation macros 24 
coding conventions 24 
macro sequence 32 
examples 38 
PRELEASE command | 67 
examples 68 
use in CTLSPOOL macro 114 
presentation services 165 
BIND parameters for 166 
PRESTART command 68 
backward/forward count in 68 
example 68 
page definition 68 
PRINTERS statement 127 
priority 1,136 
PRIPROT parameter 165 
PRMT macro 33,25 
Short form of 35 
PROCESSING status 66 
programming systems 8 
required 8 
optional 8 
PSETUP command 69 
adjusting forms alignment 69 
example 69 
page definition 69 
PSTART command 70 
buffers 70 
examples 72 
long-running jobs 71 
segmentation 71 
use of 133 
verifying diskette files 72 
volume sequence checking 72 
PSTOP command 73,1740 
EOJ overand 73,141 
examples 74 
RESTART operand 73,141 
punch task 140 
PUNCHES statement 128 
PUTACCT macro 123 
evyample of 123 
PUTSPOOL macro 29,109 


gueue entries 
creation of 7 
queue file 2,13 
formatting of 133 
Size of 11 
queue management commands 136 


RDREXIT vhase 14 
reader exit 
conventions 169 
parameter 29 
return codes 169 
user-written task 29 
READER statement 127 
reader task 139 
Teader~only partition 127,128 
real partition size 14,16 
REF parameter 
to use short PRMT from 35 
restrictions 35 
errors in referenced PRMT 35 
remote control block 15 
remote job entry 7,511,142 
devices 2 
remote operator command lanquage 137 
repeated posting of channel 12 30 
request/response unit 159 
requested operation for CTLSPOOL 113 
requesting display 
of active tasks 62 
of ALLUSERS messages 62 
of free queue records 62 
of system messages 62 
of time and date 62 
resource requirements 9 
RESTART operand of PSTOP 73 
restarting 
flushed writer task 64 
partition 139 
return codes 
from PUTSPOOL, GETSPOOL, CTLSPOOL 
from reader exit task 169 
from SEGMENT macro 125 
returning partitions 
to DOS/SVS control 142 
to POWER/VS control 142 
RJE 
(see remote job entry) 
RJE job output 
direction of 7 
RJE task 182 
RJE,BSC operations 
control of 143 
RJE,SNA facilities 163 
RJE,SNA operations 
control of 144 
RJE,SNA session 
start-up 143 
termination 145 
RJE,SNA support 
NCP requirements 23 
SIZE parameter requirement 132 
specification in POW®R macro 29 
VTAM requirements 23 
RMCB 
(see remote control block) 
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ROCL 
{see remote operator commang language) 
RSIZE 11,13 . 
RU 
(see request/response unit) 
RU deblocking algorithm 159 
RUSIZES parameter 165 


(see string control byte) 


(see single character string) 
SCS control characters 163,154 
SDLC 
(see synchronous data link control) 
SDLC terminals z 
secondary logical unit names 36 
SECPROT parameter 165 
SEGMENT macro 124 
return codes 125 
segmentation boundaries 124 
segmentation of output 4 
select vertical format 160 
SELO14 160 
separator pages/cards 
copy, separation 31,88,98 
job separation 28,88,98 
sequence of AUTOSTART statements 135 
SESSLIM parameter 36 
SETDP operator command 85 
SETPRT macro 4,125 
sign on 143 
simplified LOGON procedure 23 
sinadle character string 154 
SIZE parameter (in // EXEC) 9,132 
short form 
of central operator commands 52 
of PRMT macro 35 
SLI update statements 81,101 
SNA 
(see system network architecture) 
SNA logical unit 22 
SNA support 7 
SNA terminals 143 
SNA unit control block 15 
source statement library 81 
reserved sublibraries 102 
search sequence 101 
space calculation 
for SNA control blocks 15 
space compression/expansion 37 
SPL 
(see spool parameter list) 
SPL DSECT 107 
SPL macro 107 
SPL TYPE=MAP requirement 106 
SPMXECB 106,109 
SPOOL interface 29 
spool parameter list 107 
pDSECT 107 


Spool parameter list definition 
in CTLSPOOL macro 113 
in GETSPOOL macro 111 
in PUTSPOOL macro 109 
spooling 1 
spooling to tape 89 
START command 
use of 131 
starting lines 142 
status report 145 
example 132 
stoppving lines 141 
storage allocation 7,21,130 
storage calculation 
base values 16,17 
example 18 
storage requirements, mininum 9 
string control byte 153,156 
sublibrary 27 
SUCB 
(see SNA unit control block) 
SUPVR macro 22 
SVP 
(see select vertical format) 
synchronous data link control 143 
SYSIN files 
on diskette 72 
SYSIN mode 100,147 
SYSRDR assignment 131 
system breakdown 7 
system dispatching priority 7 
system dump t46 
system network architecture 7 
system requirements 9 


tailoring DOS/VS 7 
task management commands’ 136 
teleprocessing facility 7 
terminal attachment requirements 
for BSC 10 
for SNA 117 
terminal commands 51 
terminals 
support of 2 
termination of POWER/VS 
emergency 146 
normal 145 
termination of SNA sessions 
all sessions 145 _ 
by central operator 145 
conditional 145 
individual sessions 144 
unconditional 145 
timeout 32 
track group 27 
translate table for compaction 154 
example 155 
translate-and-test table for 
compaction 158 
example 155 
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transmission code 33 
transparency 163 
transparency feature 33,37 
TRN 
(see transparency) 
TRTC 
(see translate-and-test table for 
compaction) 
TSPROF parameter 165 


UCB 
{see universal character set buffer) 
unconditional LOGOFF 145 
unit-record devices 
support of 2 
universal character set buffer 91 
user exit 
(see reader exit) 
user information 
in *$$ JOB statement 84 
user partition 138 
user responsibilities 7 
using POWER/VS 51 
USS tailoring services 23 


VARY command tT44 
Virtual Telecommunications 
Access Method 8,143 
VM/370 8 
volume sequence checking 101 
VSIZE 4 
VTAM 
{see Virtual Telecommunications 
Access Method) 
VTAM requirements 23 
VTAM interface 
activating 72 
deactivating 7& 
partition priority 143 


WACB 

(see work area control block) 
warm start 7,133 
work area control block 15 


work sheet for POWER/VS generation 42,43 


work station package 49 
writer task 140 
writer-only partition 127 
WSP 

(see work station package) 


XECB specification 
for cross-partition communication 
XECBTAB macro 106 
XLTC 
{see translate table for comvaction) 
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